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 平臺。

開發

有關此服務器功能、使用和開發注意事項的詳細文檔，請參閱 此處。

📄 許可證

文檔中未提及相關信息。

🤝 貢獻

歡迎貢獻！如果您有任何建議或改進意見，隨時提交問題或拉取請求。讓我們一起讓這個項目變得更好！