MATLAB MCP 服务器

此模型上下文协议（MCP）服务器提供了与MATLAB的集成，允许您通过Claude或其他MCP客户端创建并执行MATLAB脚本和函数。

安装要求

• Python 3.11（当前MATLAB引擎不支持Python 3.13和3.12）
• MATLAB R2024a（或兼容版本）
• uv 包管理器

安装步骤

1. 创建并设置Python环境：

# 锁定Python版本
uv python pin 3.11

# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate

# 安装MCP
uv add "mcp[cli]"

2. 安装MATLAB引擎 当服务器首次运行时，会自动安装MATLAB引擎，使用在MATLAB_PATH环境变量中指定的MATLAB安装路径。

目录结构

• matlab_server.py: 主MCP服务器实现
• matlab_scripts/: 存储所有MATLAB脚本和函数的目录（自动创建）
• pyproject.toml: Python项目配置
• .python-version: 使用uv指定的Python版本

Claude桌面集成

1. 打开您的Claude桌面配置：

# 在macOS上
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 添加MATLAB服务器配置：

{
    "mcpServers": {
        "matlab": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/matlab-mcp",
                "run",
                "matlab_server.py"
            ],
            "env": {
                "MATLAB_PATH": "/Applications/MATLAB_R2024a.app"
            }
        }
    }
}

确保：

• 将/absolute/path/to/matlab-mcp替换为您项目的实际路径
• 验证MATLAB_PATH指向您的MATLAB安装
• 使用绝对路径（而非相对路径）

功能

服务器提供以下工具：

1. create_matlab_script: 创建新的MATLAB脚本文件

   • 脚本保存在matlab_scripts目录中
   • 文件名必须是有效的MATLAB标识符

2. create_matlab_function: 创建新的MATLAB函数文件

   • 函数保存在matlab_scripts目录中
   • 必须包含有效的函数定义

3. execute_matlab_script: 运行MATLAB脚本并获取结果

   • 返回输出文本、生成的图形和工作区变量
   • 可以向脚本传递参数

4. call_matlab_function: 带参数调用MATLAB函数

   • 返回函数输出及任何生成的图形

测试

您可以使用MCP Inspector测试服务器：

# 确保您处于虚拟环境中
source .venv/bin/activate

# 运行检查器
MATLAB_PATH=/Applications/MATLAB_R2024a.app mcp dev matlab_server.py

示例测试脚本：

t = 0:0.01:2*pi;
y = sin(t);
plot(t, y);
title('测试图');
xlabel('时间');
ylabel('振幅');

脚本存储

• 所有MATLAB脚本和函数都保存在matlab_scripts目录中
• 此目录在服务器启动时自动创建
• 文件命名为<script_name>.m或<function_name>.m
• 目录位于matlab_server.py所在位置

环境变量

• MATLAB_PATH: 指向您的MATLAB安装路径
  • 默认值：/Applications/MATLAB_R2_2024a.app
  • 在Claude桌面配置中设置或直接运行时设置

故障排除

1. MATLAB引擎安装失败

   • 验证MATLAB_PATH是否正确
   • 尝试手动安装引擎：

     cd $MATLAB_PATH/extern/engines/python
     python setup.py install
     

2. Python版本问题

   • 确保您使用的是Python 3.11
   • 检查版本：python --version
   • 如需锁定版本，请使用uv python pin 3.11

3. 脚本执行错误

   • 检查matlab_scripts目录是否存在
   • 验证脚本语法是否有效
   • 查看MATLAB输出中的错误信息

更新和维护

• 保持您的MATLAB安装更新
• 根据需要更新Python包：uv pip install --upgrade mcp[cli]
• 更新Python时检查MATLAB引擎的兼容性