matlab/simulink-agentic-toolkit

Simulink Agentic Toolkit

是什么 – 一个基于 MATLAB 的附加组件，允许大型语言模型（LLM）编码代理（Claude Code、Copilot、Codex、Gemini CLI、Sourcegraph Amp 等）读取、编辑、查询、测试和验证 Simulink® 模型。它通过将代理连接到 MATLAB MCP Server（模型-上下文-协议桥接器）并提供一个编码了模型-基于设计最佳实践的 技能目录 来实现这一功能。

核心组件

• MCP 工具 – 代理可调用的即用型命令（model_overview、model_edit、model_test 等），用于操作 Simulink 模型。
• 技能目录 – 数十个自包含的技能定义（例如：模型构建、SystemComposer 架构、验证、代码生成），每个都包含一个 manifest.yaml 文件，描述所需工具箱。
• 自动化安装程序 – 一个 MATLAB 工具箱（agenticToolkitInstaller.mltbx），通过一个命令（setupAgenticToolkit("install")）即可安装 MCP 服务器、注册工具，并将技能添加到选定的代理中。
• 库配置 – 帮助程序（satk.Configuration.setLibrary），用于将已安装的 MathWorks 块库或自定义块库暴露给代理的知识库。

工作原理

1. 安装程序启动 MATLAB MCP Server 并将其连接到正在运行的 MATLAB/Simulink 会话（shareMATLABSession）。
2. 代理加载技能文件（全局或项目级），并学习其中包含的领域知识。
3. 当代理需要对模型执行操作时，它调用一个 MCP 工具；服务器将请求转发给 MATLAB，MATLAB 执行相应的 Simulink API 调用并返回结果。

支持平台 – 任何能够消费 MCP 工具和技能的基于 LLM 的编码代理。仓库列出了对 Claude Code、GitHub Copilot、OpenAI Codex、Google Gemini CLI 和 Sourcegraph Amp 的验证自动化设置支持。

安装（快速入门）

% 1. 从最新发布版本下载工具箱
matlab.addons.toolbox.installToolbox('agenticToolkitInstaller.mltbx')
% 2. 运行安装程序（安装 MCP 服务器、注册工具和技能）
setupAgenticToolkit('install')

对于无头或代理受限环境，可如上所示通过编程方式安装工具箱。

手动设置（如需完全控制）

• 下载适用于您操作系统的 matlab-mcp-server 二进制文件，并将其放置在 ~/.matlab/agentic-toolkits/bin/ 目录中。
• 使用 ./matlab-mcp-server --setup-matlab 启动服务器，并在 MATLAB 控制台中运行 shareMATLABSession()。
• 克隆此仓库，并将 tools/tools.json 扩展添加到服务器的命令行中。
• 将技能目录符号链接到 ~/.agents/skills/（README 中提供脚本）。

典型工作流程

% 为当前 MATLAB 会话初始化工具包
addpath('~/.matlab/agentic-toolkits/simulink')
satk_initialize

% 打开一个模型（随 Simulink 一起提供的示例）
openExample('simulink_general/sldemo_househeatExample')

% 在您的 LLM 代理中询问：
%   "描述当前打开模型的结构。"
% 代理将通过 MCP 调用 `model_overview`，并返回层次结构描述。

代理可执行的操作（选定的 MCP 工具）

工具	能力
model_overview	列出子系统层次结构和主要连接
model_read	检查块参数、表达式和信号流
model_edit	添加/删除块、连接信号、配置参数
model_check	运行编辑时检查（未连接端口、状态问题）
model_test	执行 Gherkin 风格的验证测试（需要 Simulink Test）
model_query_params / model_resolve_params	检索原始或解析后的参数值
model_read_diagnostics	从诊断查看器中提取错误/警告

安全提示 – 所有工具调用应在执行前进行审查；任何修改模型或生成代码的操作都应保持人工在环。

许可证 – 请参阅 LICENSE.md。MCP 服务器的使用受 MathWorks 软件许可协议约束，仅限单个 MATLAB/Simulink 用户使用。

支持 – 在仓库中打开问题，或联系 MathWorks 技术支持。禁用了拉取请求；贡献通过常规的 GitHub 问题驱动流程接受。