前言¶
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。
