MATLAB

🚀 MATLAB MCP 服务器

此 Model Context Protocol (MCP) 服务器可实现与 MATLAB 的集成，让您能借助 Claude 或其他 MCP 客户端来创建并执行 MATLAB 脚本和函数。

🚀 快速开始

本 MCP 服务器可助力您通过 Claude 或其他 MCP 客户端与 MATLAB 进行交互，创建并执行 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 函数
   • 通过指定函数名称和输入参数来调用函数

📦 安装指南

安装要求

• 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 安装。

💻 使用示例

基础用法

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. 创建一个 MATLAB 脚本文件（例如 test_script.m）：

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

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

uv run matlab_server.py --test

📚 详细文档

目录结构

• matlab_server.py：MCP 服务器的主要实现文件
• matlab_scripts/：所有 MATLAB 脚本和函数保存在此目录（自动创建）
• pyproject.toml：Python 项目配置文件
• .python-version：指定 Python 版本的文件

脚本存储

• 所有 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. 遇到问题时，参考官方文档或联系技术支持