星战科技xingzhan.cloud
返回市场
MATLAB-MCP服务器

MATLAB-MCP服务器

作者：subspace-lab36 星标更新：2025-11-04
安装使用来源：spider==github.com

项目介绍

MATLAB MCP Server

Ask DeepWiki

一个模型上下文协议（MCP）服务器，使MATLAB与兼容MCP的应用程序（如Claude Code）无缝集成。通过高效的MCP接口执行MATLAB代码，管理工作区变量，创建图表，处理数据输入输出等。

特性

  • 执行MATLAB代码：在持久会话中运行MATLAB命令和脚本
  • 工作区管理：获取、设置、列出和清除工作区变量
  • 图形操作：保存、导出和关闭MATLAB图形（PNG、SVG、PDF等）
  • 数据I/O：导入/导出数据（CSV、JSON、XLSX）和加载/保存MAT文件
  • 环境信息：检查MATLAB版本和已安装工具箱
  • 文档访问：获取MATLAB帮助，搜索函数，查找工具箱位置
  • 高效令牌设计：多操作工具最小化API调用
  • JSON资源：结构化访问工作区、工具箱和会话信息

快速开始

前提条件：

  • 在您的系统上安装了MATLAB
  • 安装了uv包管理器（安装uv）

安装

选择下面的MCP客户端进行设置说明：

<details> <summary><b>Claude Code</b> (CLI)</summary>

使用CLI（推荐）：

# macOS (Apple Silicon)
claude mcp add --transport stdio matlab \
  --env DYLD_LIBRARY_PATH=/Applications/MATLAB_R2025b.app/bin/maca64 \
  -- uvx matlab-mcp-server

# macOS (Intel)
claude mcp add --transport stdio matlab \
  --env DYLD_LIBRARY_PATH=/Applications/MATLAB_R2025b.app/bin/maci6
  -- uvx matlab-mcp-server

# Linux
claude mcp add --transport stdio matlab \
  --env LD_LIBRARY_PATH=/usr/local/MATLAB/R2024b/bin/glnxa64 \
  -- uvx matlab-mcp-server

作用域选项：

  • 默认（本地）：仅限您自己，仅此项目
  • --scope project：与团队共享（存储在.mcp.json，可以提交到git）
  • --scope user：跨所有项目可用

手动配置（项目根目录中的.mcp.json）：

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": ["matlab-mcp-server"],
      "env": {
        "DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
      }
    }
  }
}

替换为您自己的MATLAB路径。Linux使用LD_LIBRARY_PATH。

验证：

claude mcp list
claude mcp info matlab
</details> <details> <summary><b>Claude Desktop</b></summary>

配置文件位置：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": ["matlab-mcp-server"],
      "env": {
        "DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
      }
    }
  }
}

特定平台的环境变量：

  • macOS (Apple Silicon)："DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
  • macOS (Intel)："DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maci64"
  • Linux："LD_LIBRARY_PATH": "/usr/local/MATLAB/R2024b/bin/glnxa64"
  • Windows：通常不需要（安装程序处理库路径）

步骤：

  1. 在上述位置创建或编辑配置文件
  2. 添加正确的MATLAB路径的MCP服务器配置
  3. 完全重启Claude Desktop（退出并重新打开）
  4. 查找Claude Desktop界面中的MCP服务器图标（🔨）
</details> <details> <summary><b>Cursor</b></summary>

UI配置：

前往Cursor 设置 → MCP → 添加新的MCP服务器：

  • 名称：matlab
  • 命令：uvx matlab-mcp-server
  • 点击编辑以添加环境变量

配置文件位置：

  • macOS：~/Library/Application Support/Cursor/mcp_config.json
  • Windows：%APPDATA%\Cursor\mcp_config.json
  • Linux：~/.config/Cursor/mcp_config.json

配置：

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": ["matlab-mcp-server"],
      "env": {
        "DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
      }
    }
  }
}

替换为您自己的MATLAB路径（参见Claude Desktop部分的特定平台路径）。

步骤：

  1. 如果不存在，请创建mcp_config.json
  2. 添加MCP服务器配置
  3. 完全重启Cursor
</details> <details> <summary><b>VS Code</b> (GitHub Copilot)</summary>

VS Code设置（用户或工作区）：

{
  "github.copilot.chat.mcp.servers": {
    "matlab": {
      "command": "uvx",
      "args": ["matlab-mcp-server"],
      "env": {
        "DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
      }
    }
  }
}

CLI安装：

# macOS (Apple Silicon)
code --add-mcp '{"name":"matlab","command":"uvx","args":["matlab-mcp-server"],"env":{"DYLD_LIBRARY_PATH":"/Applications/MATLAB_R2025b.app/bin/maca64"}}'

# Linux
code --add-mcp '{"name":"matlab","command":"uvx","args":["matlab-mcp-server"],"env":{"LD_LIBRARY_PATH":"/usr/local/MATLAB/R2024b/bin/glnxa64"}}'

替换为您自己的MATLAB路径（参见Claude Desktop部分的特定平台路径）。

资源：

</details> <details> <summary><b>Codex</b></summary>

CLI：

codex mcp add matlab uvx "matlab-mcp-server"

然后手动编辑~/.codex/config.toml以添加环境变量：

编辑~/.codex/config.toml：

[mcp_servers.matlab]
command = "uvx"
args = ["matlab-mcp-server"]

[mcp_servers.matlab.env]
DYLD_LIBRARY_PATH = "/Applications/MATLAB_R2025b.app/bin/maca64"

特定平台的环境变量：

  • macOS (Apple Silicon)：DYLD_LIBRARY_PATH = "/Applications/MATLAB_R2025b.app/bin/maca64"
  • macOS (Intel)：DYLD_LIBRARY_PATH = "/Applications/MATLAB_R2025b.app/bin/maci64"
  • Linux：LD_LIBRARY_PATH = "/usr/local/MATLAB/R2024b/bin/glnxa64"

资源：

</details>

对于其他11个客户端（Windsurf, Continue, Amp, Cline, Gemini CLI, Goose, Kiro, LM Studio, opencode, Qodo Gen, Warp），请参阅**完整设置指南 →**

查找您的MATLAB库路径

如果您不知道MATLAB库路径，可以使用配置助手：

curl -fsSL https://raw.githubusercontent.com/subspace-lab/matlab-mcp-server/main/install-matlab-mcp.sh | bash

该脚本将：

  • 自动检测您的MATLAB安装
  • 显示带有正确路径的配置
  • 您将其复制粘贴到MCP客户端的配置文件中

就这样！当您的MCP客户端启动时，uvx将自动：

  • 从PyPI下载matlab-mcp-server
  • 安装matlabengine及其所有依赖项
  • 启动MATLAB MCP服务器

手动安装

如果您希望手动安装或自动化安装程序不起作用：

1. 安装matlabengine

# 导航到您的MATLAB Python引擎目录
cd /Applications/MATLAB_R20XXx.app/extern/engines/python  # macOS
# 或
cd /usr/local/MATLAB/R20XXx/extern/engines/python  # Linux

# 使用uv安装
uv pip install .

将R20XXx替换为您的MATLAB版本（例如，R2024a，R2024b，R2025a）。

2. 安装matlab-mcp-server

uv pip install matlab-mcp-server

3. 配置MCP服务器

按照上面各部分中针对您的MCP客户端的配置说明进行操作。使用matlab-mcp作为命令，而不是uvx matlab-mcp-server。

示例对于Claude Code（项目根目录中的.mcp.json）：

{
  "mcpServers": {
    "matlab": {
      "command": "matlab-mcp",
      "env": {
        "DYLD_LIBRARY_PATH": "/Applications/MATLAB_R2025b.app/bin/maca64"
      }
    }
  }
}

替换为您自己的MATLAB路径：

  • macOS (Apple Silicon)：DYLD_LIBRARY_PATH → /Applications/MMATLAB_R20XXx.app/bin/maca64
  • macOS (Intel)：DYLD_LIBRARY_PATH → /Applications/MATLAB_R20XXx.app/bin/maci64
  • Linux：LD_LIBRARY_PATH → /usr/local/MATLAB/R20XXx/bin/glnxa64
  • Windows：通常不需要

对于其他MCP客户端，请参阅上面的配置部分或MCP_CLIENT_SETUP.md

可用工具

服务器提供8个MCP工具用于与MATLAB交互：

  • execute_matlab - 执行MATLAB代码并获取结果
  • workspace - 管理工作区变量（获取、设置、列出、清除）
  • figure - 保存、导出和管理MATLAB图形（PNG、SVG、PDF等）
  • data_io - 导入/导出各种格式的数据（CSV、JSON、XLSX、MAT文件）
  • env - 获取MATLAB版本和检查已安装工具箱
  • get_help - 访问MATLAB文档和搜索函数
  • route_intent - 建议适当的工具模式（元工具）
  • select_mode - 启用可选工具组（元工具）

有关每个工具的详细文档，请参阅TOOLS.md或MATLAB_MCP_GUIDE.md。

故障排除

MATLAB引擎未找到

如果您遇到关于MATLAB引擎未找到的错误：

  1. 确保MATLAB已正确安装
  2. 验证已安装MATLAB引擎API for Python
  3. 检查Python版本是否与MATLAB兼容
  4. 验证配置中的库路径是否正确设置

库路径问题

默认MATLAB位置：

  • macOS：/Applications/MATLAB_R20XXx.app
  • Linux：/usr/local/MATLAB/R20XXx
  • Windows：C:\Program Files\MATLAB\R20XXx

如果MATLAB位于非标准位置，请更新配置中的库路径。

文档

许可

MIT许可

贡献

欢迎贡献！请参阅CONTRIBUTING.md了解开发设置和指南。

Star历史

Star历史图表