Skip to content

Home

Jump to bottom
github-actions[bot] edited this page Mar 18, 2026 · 21 revisions

MATLAB MCP Server Wiki

Welcome to the MATLAB MCP Server wiki! This server connects any AI agent to a shared MATLAB installation via the Model Context Protocol (MCP).

Quick Navigation

  • Installation — Prerequisites, MATLAB Engine API, server setup
  • Configuration — Full YAML config reference with all options
  • MCP Tools Reference — All built-in tools with parameters and examples
  • Custom Tools — Expose your own .m functions as AI-callable tools
  • Examples — Ready-to-run MATLAB examples for common tasks
  • Architecture — System design, engine pool, async jobs, session model
  • Async Jobs — Long-running jobs, progress reporting, job lifecycle
  • Security — Function blocklist, workspace isolation, upload limits
  • Monitoring — Dashboard, health checks, metrics endpoints
  • Troubleshooting — Common issues and solutions
  • FAQ — Frequently asked questions

What is this?

A Python MCP server that gives AI agents (Claude, Cursor, Copilot, custom agents) the ability to:

  • Execute MATLAB code — sync for fast commands, async for long-running jobs
  • Discover toolboxes — browse installed toolboxes, functions, and help text
  • Check code quality — run checkcode/mlint before execution
  • Get interactive plots — figures auto-converted to Plotly JSON
  • Use custom libraries — expose your .m/.mex functions as first-class MCP tools
  • Run multi-user sessions — elastic engine pool with per-user workspace isolation

Key Features

Feature Description
Execute MATLAB code Sync for fast commands, auto-async for long jobs
Elastic engine pool Scales 2-10+ engines based on demand
Toolbox discovery Browse installed toolboxes, functions, help text
Code checker Run checkcode/mlint before execution
Interactive plots Figures auto-converted to Plotly JSON
Multi-user (SSE) Session isolation with per-user workspaces
Custom tools Expose your .m functions as MCP tools via YAML
Progress reporting Long jobs report percentage back to the agent
Monitoring dashboard Web UI + JSON health/metrics endpoints
Cross-platform Windows + macOS, MATLAB 2020b+

Supported Platforms

Platform MATLAB Version Transport
macOS 2020b+ stdio, SSE
Windows 2020b+ stdio, SSE
Docker 2020b+ stdio, SSE

Quick Start

Install

# From PyPI
pip install matlab-mcp-python

# Or from source
git clone https://github.com/HanSur94/matlab-mcp-server-python.git
cd matlab-mcp-server-python
pip install -e ".[dev]"

Run

# Single user (stdio)
matlab-mcp

# Multi-user (SSE)
matlab-mcp --transport sse

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "matlab": {
      "command": "matlab-mcp"
    }
  }
}

Getting Help

Clone this wiki locally