Matlabmcp

🚀 MATLAB MCP 集成

本项目是为 MATLAB 实现的 Model Context Protocol (MCP) 服务器。它借助 MATLAB 引擎 API for Python，让 MCP 客户端（像 LLM 代理或 Claude Desktop）能与共享的 MATLAB 会话进行交互，有效提升了 MATLAB 与外部客户端的通信效率。

✨ 主要特性

• 执行 MATLAB 代码：可使用 runMatlabCode 工具运行任意 MATLAB 代码片段。
• 获取变量：通过 getVariable 工具获取 MATLAB 工作区中的变量值。
• 结构化通信：工具返回的结果和错误以结构化的 JSON 形式呈现，方便客户端进行编程处理。
• 非阻塞执行：利用 asyncio.to_thread 异步运行 MATLAB 引擎调用，避免阻塞服务器。
• 标准日志记录：运用 Python 的标准 logging 模块，将日志输出到 stderr，便于在客户端日志中查看。
• 共享会话：能够连接到一个现有的共享 MATLAB 会话。

待办事项：

• 添加 setVariable 工具，用于将数据写入 MATLAB 工作区。
• 添加 runScript 工具，可直接执行 .m 文件。
• 增加工作区管理工具（例如 clearWorkspace，getWorkspaceVariables）。
• 扩展 matlab_to_python 辅助函数，使其支持更多复杂数据类型（结构体、单元格数组、对象）。
• 添加对 Simulink 模型的交互支持。

📦 安装指南

克隆仓库

git clone https://github.com/jigarbhoye04/MatlabMCP.git
cd MatlabMCP

设置 Python 虚拟环境（推荐）

# 如果尚未安装，请先安装 uv：https://github.com/astral-sh/uv
uv init
uv venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

安装依赖项

uv pip sync

配置 MATLAB

确保 MATLAB 已安装，并且 MATLAB 引擎 API for Python 配置完成。请参考 MATLAB 文档。

启动并共享 MATLAB 引擎

在 MATLAB 命令窗口运行以下命令：

matlab.engine.shareEngine

您可以通过在 MATLAB 中运行 matlab.engine.isEngineShared 来验证是否已共享（它应返回 true）。

📚 详细文档

配置

将此服务器与 Claude Desktop 集成的说明：

1. 在您的项目中克隆此仓库。
2. 在 config.json 文件中填写必要的配置信息，例如 API 密钥和端点。
3. 启动服务器并连接到 Claude 平台。

开发

有关此服务器功能、使用和开发注意事项的详细文档，请参阅 此处。

📄 许可证

文档中未提及相关信息。

🤝 贡献

欢迎贡献！如果您有任何建议或改进意见，随时提交问题或拉取请求。让我们一起让这个项目变得更好！