前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的理念。當開發者需要智能體直接操作 MATLAB 代碼或 Simulink 模型時，通常需要編寫額外的控制腳本。dsh-matlab-mcp 通過註冊 MathWorks MCP 服務器，將 MATLAB/Simulink 的控制能力注入到 DSH GUI 中，使智能體會話獲得原生的 mcp__matlab__* 工具。
插件介紹¶
名稱：dsh-matlab-mcp
所有者：James-web11
許可證：MIT
定位：DeepSeek Harness (dsh) profile bundle，用於將 MathWorks MATLAB/Simulink MCP 服務器註冊到 dsh GUI。
核心功能¶
插件通過 mcp__matlab__* 前綴的接口暴露能力，涵蓋以下場景：
- MATLAB 代碼執行：運行任意 MATLAB 代碼，執行腳本或運行單元測試。
- 靜態分析：對
.m文件進行靜態代碼檢查，獲取警告信息。 - 環境檢測：檢測 MATLAB 版本及已安裝的工具箱。
- Simulink 交互：
- 查看：提供分層模型視圖、塊拓撲和表達式符號表示。
- 編輯：執行結構編輯或參數修改。
- 驗證：檢查結構有效性（如未連接的端口）。
- 查詢：隨機訪問任意塊/配置參數。
- 變量解析：將工作區變量解析爲 Simulink 的值。
- 測試：基於 Gherkin 語法的 Simulink 行爲測試（需 Simulink Test）。
環境要求¶
在安裝前，請確保環境滿足以下條件：
- MATLAB 版本：R2021a 或更高版本（使用 Simulink
model_*工具需要 R2023a 或更高版本）。 - MATLAB Agentic Toolkit：必須安裝。在 MATLAB 中執行
setupAgenticToolkit("install")來安裝。 - pnpm：
dsh plugin工具依賴 pnpm。 - DSH 啓動器：
dsh命令需在 PATH 中，或使用npx。
安裝¶
推薦通過 dsh plugin 命令直接添加配置包：
dsh plugin --profile web add github:<your-account>/dsh-matlab-mcp
此命令會將插件配置添加到 ~/.dsh/profiles/web/cordis.patch.yml。安裝後需要重啓 GUI。
啓動與使用¶
- 重啓 GUI：安裝完成後必須重啓 dsh GUI。
- 啓動 MATLAB：確保 MATLAB 已運行。服務器通過
--matlab-session-mode=existing附加到現有會話，不會自動啓動 MATLAB。 - 初始化：在 MATLAB 會話中執行以下命令以共享會話：
addpath('~/.matlab/agentic-toolkits/simulink');
satk_initialize
驗證與典型用法¶
GUI 重啓後，智能體即可使用相關工具。例如：
* 檢測環境：詢問智能體 mcp__matlab__detect_matlab_toolboxes 以列出工具箱。
* 查看模型：詢問智能體 mcp__matlab__model_overview 以獲取 Simulink 模型的概覽。
注意事項¶
- 路徑解析：配置中的路徑在配置生成時通過
!!js表達式解析，無需手動爲每臺機器修改路徑。 - Windows 依賴：Windows 環境下需要注入
WINDIR環境變量。 - 超時設置：如果執行長時間仿真，可能需要增加
toolCallTimeoutMs（默認 600000ms）。 - 源碼說明：該倉庫僅包含配置文件，MCP 服務器本體由 MathWorks 提供，客戶端插件爲
@deepseek-ai/dsh-mcp-client。
