MATLAB

🚀 MATLAB MCP 服務器

此 Model Context Protocol (MCP) 服務器可與 MATLAB 集成，讓您能通過 Claude 或其他 MCP 客戶端創建並執行 MATLAB 腳本和函數，為 MATLAB 的使用提供了更便捷的途徑。

🚀 快速開始

本 MCP 服務器可實現與 MATLAB 的集成，藉助 Claude 或其他 MCP 客戶端，您就能輕鬆創建和執行 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 安裝。

💻 使用示例

基礎用法

測試驗證

1. 創建一個 MATLAB 腳本文件（例如 test_script.m）：

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

2. 在服務器上運行測試腳本：

   uv run matlab_server.py --test
   

高級用法

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 目錄中。
• 每個腳本或函數文件應具有唯一的名稱，並遵循 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. 遇到問題時，參考官方文檔或聯繫技術支持。