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

注意事項

• 安裝完成後，請確保所有路徑正確配置。
• 如果遇到問題，請檢查日誌輸出以獲取更多信息。