Matlab

🚀 MATLAB MCP 服务器

此 Model Context Protocol (MCP) 服务器提供与 MATLAB 的集成能力，让您能够通过 Claude 或其他 MCP 客户端创建并执行 MATLAB 脚本和函数，极大地提升了 MATLAB 脚本和函数的创建与执行效率。

🚀 快速开始

此 Model Context Protocol (MCP) 服务器提供与 MATLAB 的集成能力，让您能够通过 Claude 或其他 MCP 客户端创建并执行 MATLAB 脚本和函数，极大地提升了 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 函数并传递参数，返回函数输出和任何生成的图形。

📦 安装指南

安装要求

• 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 测试脚本示例：

t = 0:0.01:2*pi;
y = sin(t);
plot(t, y);
title('Test Plot');
xlabel('Time');
ylabel('Amplitude');

高级用法

在 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 安装位置。
• 请使用绝对路径（不要用相对路径）。

📚 详细文档

目录结构

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

脚本存储

• 所有 MATLAB 脚本和函数都保存在 matlab_scripts 目录中。
• 该目录在服务器启动时自动创建。
• 文件名为 <script_name>.m 或 <function_name>.m。
• 确保脚本和函数命名清晰，避免与现有文件冲突。

测试

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

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

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

注意事项

• 安装完成后，请确保所有路径正确配置。
• 如果遇到问题，请检查日志输出以获取更多信息。