# matlab/matlab-mcp-core-server architecture

> Architecture diagram of the GitHub repository matlab/matlab-mcp-core-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/matlab/matlab-mcp-core-server
- Repository: https://github.com/matlab/matlab-mcp-core-server

## Overview

MATLAB MCP Server exposes MATLAB session management and code-execution capabilities to MCP-compatible AI clients. The primary flow is client request → MCP server/tool → MATLAB use case → session manager and MATLAB connection. README documents starting/quitting MATLAB, running code, and assessing code; the sampled source confirms the executable entry point, SDK server construction, and key session/connection layers. The source excerpts do not show tool-to-use-case calls, so those links are marked unverified rather than asserted.

Main entry points: [`internal/adaptors/mcp/tools/tools.go`](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/tools/tools.go) (MCP tools), [`internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go`](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go) (Session manager), [`internal/adaptors/mcp/server/server.go`](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/server/server.go) (MCP server), [`cmd/matlab-mcp-server/main.go`](https://github.com/matlab/matlab-mcp-core-server/blob/main/cmd/matlab-mcp-server/main.go) (Executable)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Server entry"]
  node_entrypoint["Executable<br/>[main.go]"]
  node_publicserver["Server API<br/>[server.go]"]
  node_sdkserver["SDK server<br/>[server.go]"]
  node_wire["Dependency wiring<br/>[wire.go]"]
end

subgraph group_mcp["MCP interface"]
  node_mcpserver["MCP server<br/>[server.go]"]
  node_tools["MCP tools<br/>[tools.go]"]
  node_resources["MCP resources<br/>[resources.go]"]
end

subgraph group_operations["MATLAB operations"]
  node_eval["Evaluate code<br/>[evalmatlabcode.go]"]
  node_check["Assess code<br/>[checkmatlabcode.go]"]
  node_runfile["Run MATLAB file<br/>[runmatlabfile.go]"]
  node_runtest["Run test file"]
  node_toolbox["Detect toolboxes"]
  node_start["Start session"]
  node_stop["Stop session"]
  node_list["List MATLABs"]
end

subgraph group_runtime["MATLAB runtime"]
  node_manager["Session manager<br/>[sessionmanager.go]"]
  node_matlabmanager["MATLAB manager<br/>[matlabmanager.go]"]
  node_connector["Embedded connector<br/>[client.go]"]
end

node_ai(("AI application"))
node_matlab(("MATLAB"))

node_ai -->|"requests service"| node_entrypoint
node_entrypoint -->|"creates server"| node_publicserver
node_publicserver -->|"constructs"| node_sdkserver
node_sdkserver -->|"uses adaptor"| node_wire
node_wire -->|"binds server"| node_mcpserver
node_mcpserver -->|"registers tools"| node_tools
node_mcpserver -->|"registers resources"| node_resources
node_tools -.->|"dispatches"| node_eval
node_tools -.->|"dispatches"| node_check
node_tools -.->|"dispatches"| node_runfile
node_tools -.->|"dispatches"| node_runtest
node_tools -.->|"dispatches"| node_toolbox
node_tools -.->|"dispatches"| node_start
node_tools -.->|"dispatches"| node_stop
node_tools -.->|"dispatches"| node_list
node_start -.->|"starts session"| node_manager
node_stop -.->|"stops session"| node_manager
node_eval -.->|"uses session"| node_manager
node_check -.->|"uses session"| node_manager
node_runfile -.->|"uses session"| node_manager
node_runtest -.->|"uses session"| node_manager
node_manager -->|"delegates"| node_matlabmanager
node_matlabmanager -->|"creates client"| node_connector
node_connector -->|"connects"| node_matlab

click node_entrypoint "https://github.com/matlab/matlab-mcp-core-server/blob/main/cmd/matlab-mcp-server/main.go"
click node_publicserver "https://github.com/matlab/matlab-mcp-core-server/blob/main/pkg/server/server.go"
click node_sdkserver "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/sdk/server/server.go"
click node_wire "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/wire/wire.go"
click node_mcpserver "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/server/server.go"
click node_tools "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/tools/tools.go"
click node_resources "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/resources/resources.go"
click node_eval "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/evalmatlabcode/evalmatlabcode.go"
click node_check "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/checkmatlabcode/checkmatlabcode.go"
click node_runfile "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/runmatlabfile/runmatlabfile.go"
click node_runtest "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/runmatlabtestfile/runmatlabtestfile.go"
click node_toolbox "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/detectmatlabtoolboxes/detectmatlabtoolboxes.go"
click node_start "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/startmatlabsession/startmatlabsession.go"
click node_stop "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/stopmatlabsession/stopmatlabsession.go"
click node_list "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/listavailablematlabs/listavailablematlabs.go"
click node_manager "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go"
click node_matlabmanager "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/matlabmanager/matlabmanager.go"
click node_connector "https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/matlabmanager/matlabsessionclient/embeddedconnector/client.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entrypoint,node_publicserver,node_sdkserver,node_wire toneBlue
class node_mcpserver,node_tools,node_resources toneAmber
class node_eval,node_check,node_runfile,node_runtest,node_toolbox,node_start,node_stop,node_list toneMint
class node_manager,node_matlabmanager,node_connector toneRose
class node_ai,node_matlab toneIndigo
```

## Components

### Server entry

- [Executable](https://github.com/matlab/matlab-mcp-core-server/blob/main/cmd/matlab-mcp-server/main.go): `cmd/matlab-mcp-server/main.go`
- [Server API](https://github.com/matlab/matlab-mcp-core-server/blob/main/pkg/server/server.go): `pkg/server/server.go`
- [SDK server](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/sdk/server/server.go): `internal/adaptors/sdk/server/server.go`
- [Dependency wiring](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/wire/wire.go): `internal/wire/wire.go`

### MCP interface

- [MCP server](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/server/server.go): `internal/adaptors/mcp/server/server.go`
- [MCP tools](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/tools/tools.go): `internal/adaptors/mcp/tools/tools.go`
- [MCP resources](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/mcp/resources/resources.go): `internal/adaptors/mcp/resources/resources.go`

### MATLAB operations

- [Evaluate code](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/evalmatlabcode/evalmatlabcode.go): `internal/usecases/evalmatlabcode/evalmatlabcode.go`
- [Assess code](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/checkmatlabcode/checkmatlabcode.go): `internal/usecases/checkmatlabcode/checkmatlabcode.go`
- [Run MATLAB file](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/runmatlabfile/runmatlabfile.go): `internal/usecases/runmatlabfile/runmatlabfile.go`
- [Run test file](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/runmatlabtestfile/runmatlabtestfile.go): `internal/usecases/runmatlabtestfile/runmatlabtestfile.go`
- [Detect toolboxes](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/detectmatlabtoolboxes/detectmatlabtoolboxes.go): `internal/usecases/detectmatlabtoolboxes/detectmatlabtoolboxes.go`
- [Start session](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/startmatlabsession/startmatlabsession.go): `internal/usecases/startmatlabsession/startmatlabsession.go`
- [Stop session](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/stopmatlabsession/stopmatlabsession.go): `internal/usecases/stopmatlabsession/stopmatlabsession.go`
- [List MATLABs](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/usecases/listavailablematlabs/listavailablematlabs.go): `internal/usecases/listavailablematlabs/listavailablematlabs.go`

### MATLAB runtime

- [Session manager](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go): `internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go`
- [MATLAB manager](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/matlabmanager/matlabmanager.go): `internal/adaptors/matlabmanager/matlabmanager.go`
- [Embedded connector](https://github.com/matlab/matlab-mcp-core-server/blob/main/internal/adaptors/matlabmanager/matlabsessionclient/embeddedconnector/client.go): `internal/adaptors/matlabmanager/matlabsessionclient/embeddedconnector/client.go`

### Other components

- **AI application**
- **MATLAB**

## Connections

- AI application → Executable: requests service (evidence: `README.md`)
- Executable → Server API: creates server (evidence: `cmd/matlab-mcp-server/main.go`)
- Server API → SDK server: constructs (evidence: `pkg/server/server.go`)
- SDK server → Dependency wiring: uses adaptor (evidence: `internal/adaptors/sdk/server/server.go`)
- Dependency wiring → MCP server: binds server (evidence: `internal/wire/wire.go`)
- MCP server → MCP tools: registers tools (evidence: `internal/adaptors/mcp/server/server.go`)
- MCP server → MCP resources: registers resources (evidence: `internal/adaptors/mcp/server/server.go`)
- MCP tools → Evaluate code: dispatches
- MCP tools → Assess code: dispatches
- MCP tools → Run MATLAB file: dispatches
- MCP tools → Run test file: dispatches
- MCP tools → Detect toolboxes: dispatches
- MCP tools → Start session: dispatches
- MCP tools → Stop session: dispatches
- MCP tools → List MATLABs: dispatches
- Start session → Session manager: starts session
- Stop session → Session manager: stops session
- Evaluate code → Session manager: uses session
- Assess code → Session manager: uses session
- Run MATLAB file → Session manager: uses session
- Run test file → Session manager: uses session
- Session manager → MATLAB manager: delegates (evidence: `internal/adaptors/globalmatlab/sessionmanager/sessionmanager.go`)
- MATLAB manager → Embedded connector: creates client (evidence: `internal/adaptors/matlabmanager/matlabmanager.go`)
- Embedded connector → MATLAB: connects (evidence: `internal/adaptors/matlabmanager/matlabsessionclient/embeddedconnector/client.go`)
