dsh-matlab-mcp-plugin

DSH bundle 插件：将 MATLAB MCP Server（MathWorks 官方）接入 DeepSeek Harness，Agent 由此获得 MATLAB / Simulink 能力。

本包只有一个功能文件 cordis.patch.yml（bundle 层 patch），通过 @deepseek-ai/dsh-mcp-client 以 stdio 子进程拉起 MCP Server；无 JS 运行时代码。

提供的工具

基础 5 工具 + Simulink Agentic Toolkit 扩展 9 工具（共 14）：

工具名统一为 mcp__matlab__<上表名称>。

前置条件

1. MATLAB R2021a+。
2. MATLAB MCP Server 二进制，二选一：
   • MathWorks Agentic Toolkits（推荐，自带 Simulink 扩展）：安装后位于 ~/.matlab/agentic-toolkits/bin/matlab-mcp-server，插件默认即指向它；
   • 独立 release 二进制：bash setup.sh 下载，或从 releases 手动下载，然后设置 MATLAB_MCP_SERVER_BINARY 指向它。

安装

# 试跑
dsh web --patch /path/to/dsh-matlab-mcp-plugin/cordis.patch.yml

# 长期使用（profile bundle）
cd ~/.dsh/profiles/web && dsh plugin add /path/to/dsh-matlab-mcp-plugin

配置（环境变量）

自定义覆盖（profile 的 cordis.patch.yml 中按 id 覆盖；注意 args 是整体替换，需带全所有 flag）：

- id: matlab-mcp
  config:
    command: '/custom/path/matlab-mcp-server'
    args:
      - '--matlab-root=/usr/local/MATLAB/R2024b'
      - '--matlab-session-mode=new'
      - '--initialize-matlab-on-startup=false'
      - '--extension-file'
      - '/path/to/agentic-toolkits/simulink/tools/tools.json'
    toolCallTimeoutMs: 300000

常用 server flag：--matlab-root、--initial-working-folder、--matlab-display-mode=desktop|nodesktop、--matlab-session-mode=new|auto|existing、--initialize-matlab-on-startup、--log-level、--disable-telemetry。

故障排查

• 只有 5 个工具（无 model_*）：--extension-file 与其路径必须作为两个独立 arg 成对出现，裸路径会被当位置参数静默忽略（2026-09-27 实测）。
• 工具全部缺失：failOnStartupError: false 会静默降级；用 --log-level=debug 看 server 日志，通常是二进制路径不对（检查 MATLAB_MCP_SERVER_BINARY）。
• 找不到 MATLAB：设置 MW_MCP_SERVER_MATLAB_ROOT。
• 长仿真超时：调大 toolCallTimeoutMs（默认 120000）。

架构

DSH Agent → @deepseek-ai/dsh-mcp-client → (stdio) MATLAB MCP Server → MATLAB Runtime

许可

Apache-2.0（仅覆盖本包内容；MathWorks 二进制及其依赖受各自许可约束）。