MATLAB MCP 服务器

此 Model Context Protocol (MCP) 服务器提供与 MATLAB 的集成，允许您通过 Claude 或其他 MCP 客户端创建和执行 MATLAB 脚本和函数。

安装要求

• Python 3.11（目前不支持 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：指定 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 目录中
   • 文件名必须遵循 MATLAB 函数命名规则

3. execute_matlab_script：执行 MATLAB 脚本

   • 通过指定脚本路径和参数来运行脚本

4. call_matlab_function：调用 MATLAB 函数

   • 通过指定函数名称和输入参数来调用函数

测试验证

1. 创建一个 MATLAB 脚本文件（例如 test_script.m）：

   function result = test_function(input)
       result = input + 1;
   end
   

2. 在服务器上运行测试脚本：

   uv run matlab_server.py --test
   

脚本存储

• 所有 MATLAB 脚本和函数均保存在 matlab_scripts 目录中
• 每个脚本或函数文件应具有唯一的名称，并遵循 MATLAB 的命名规范

环境变量

• MATLAB_PATH：指定 MATLAB 安装目录的位置，默认为 /Applications/MATLAB_R2024a.app

故障排除

1. MATLAB 引擎安装失败

   • 检查 MATLAB_PATH 是否正确
   • 确保 MATLAB 已正确安装并具有可执行权限

2. Python 版本不兼容

   • 验证 Python 版本是否为 3.11
   • 使用 uv python version 命令检查当前 Python 版本

3. 脚本或函数无法执行

   • 检查脚本或函数文件是否存在语法错误
   • 确保脚本或函数具有可执行权限

更新维护

1. 定期检查 MATLAB 和 Python 的最新版本
2. 使用 uv update 命令更新 MCP 服务器和相关依赖项
3. 遇到问题时，参考官方文档或联系技术支持