matlab/simulink-agentic-toolkit

Simulink Agentic Toolkit 简介

Simulink Agentic Toolkit 是一个基于 MATLAB 的加载项，允许大型语言模型(LLM)编码代理（Claude Code、GitHub Copilot、OpenAI Codex、Gemini CLI、Sourcegraph Amp 等）直接与 Simulink 模型交互。它通过以下方式实现：

1. 运行 MATLAB MCP(Model-Context-Protocol) 服务器 – 一个小型桥接器，将 MATLAB/Simulink 函数公开为代理可以调用的“工具”。
2. 提供“技能”目录 – 可重用的、领域特定的提示，编码了基于模型的设计最佳实践（构建、测试、需求、代码生成等）。
3. 打包安装程序 – 自动设置 MCP 服务器，向所选代理注册技能，并配置 MATLAB 路径。

简而言之，该工具包为 LLM 提供了 知识（技能）和 能力（MCP 工具），使其能够像人类工程师一样读取、编辑、查询、测试和验证 Simulink 模型。

---

主要功能

功能	它给代理提供什么	为什么重要
MCP 工具	model_read、model_edit、model_test、model_check、model_query_params 等	使代理能够在实时 Simulink 会话中执行具体操作，无需手动编写脚本。
技能目录	涵盖核心 MBD、系统工程、验证、仿真、控制、代码生成、实时测试等 12 个以上的技能组。	编码了行业标准工作流程（例如 MISRA 检查、Gherkin 风格测试），确保代理遵循最佳实践而不是产生幻觉。
自动安装程序 (agenticToolkitInstaller.mltbx)	一键设置 MCP 服务器、工具箱路径和技能注册；还支持卸载/更新。	降低了工程师尝试代理辅助建模的门槛。
跨代理支持	与 Claude Code、Copilot、Codex、Gemini CLI、Sourcegraph Amp 兼容（均已验证）。	使团队可以灵活地使用他们偏好的 LLM 编码助手。
自定义库索引	satk.Configuration.setCustomLibraries 从用户定义的 Simulink 块库构建知识库。	允许代理理解专有块并在生成的模型中重用它们。
安全第一的设计	需要人工审查工具调用；MCP 规范包括用户交互和安全指南。	防止对关键模型进行意外的破坏性更改。

---

典型工作流程

1. 通过提供的 .mltbx 安装程序安装工具包（或手动设置 MCP 服务器）。
2. 运行 setupAgenticToolkit("install")，它将：
   • 安装 MCP 服务器二进制文件。
   • 将工具包添加到 MATLAB 路径。
   • 向您选择的 LLM 代理注册技能目录。
3. 启动一个加载了 Simulink 的 MATLAB 会话，并调用 satk_initialize（每个会话一次）。这将与会话共享给 MCP 服务器。
4. 请求 LLM 执行任务，例如：

   "向植物模型添加 PID 控制器并调整 Kp、Ki、Kd。"
   

   代理读取适当的技能，然后通过 MCP 调用 model_edit（添加块、设置参数）和 model_test（运行 Gherkin 测试）。
5. 验证结果 – 工具包会显示诊断信息、模型层次结构或仿真输出供人工审查。

---

适用人群

受众	受益点
控制/机电一体化工程师	更快的原型迭代；LLM 可以根据高级规范生成或修改控制器块。
系统工程师	通过技能自动更新 System Composer 架构和需求追溯。
验证团队	自动生成 Gherkin 风格测试夹具，运行 Model Advisor 检查，并生成合规性报告。
工具开发者/研究人员	LLM 驱动的基于模型设计的具体示例；可以扩展技能目录或试验新代理。

---

限制与注意事项

• 需要 MATLAB R2023a+ 与 Simulink；该工具包不能在开源 Octave 生态系统中运行。
• 某些工具（例如 model_test）需要额外的 MathWorks 产品，如 Simulink Test。
• MCP 服务器 仅限单用户使用；多个用户共享服务器违反 MathWorks 许可。
• 虽然工具包致力于防止幻觉，但 人工监督 仍然至关重要，尤其是对于安全关键模型。

---

快速开始

% 1. 安装加载项（先下载 .mltbx 文件）
matlab.addons.toolbox.installToolbox('agenticToolkitInstaller.mltbx')

% 2. 运行自动设置
setupAgenticToolkit('install')

% 3. 为当前 MATLAB 会话初始化
satk_initialize

% 4. 打开演示模型并询问代理
openExample('simulink_general/sldemo_househeatExample')
% 在 LLM 聊天窗口中：
%   "描述当前打开的模型的结构。"

---

更多信息

• 完整文档 – Configuration_and_Troubleshooting.md、skills-catalog/README.md。
• 许可证 – 请参阅 LICENSE.md（MathWorks 专有许可）。
• 错误报告 – 使用内置的 filing-bug-reports 技能或在上打开问题。
• 研究预览 – slAgenticTaskExplorer 展示了代理可以执行的多步骤任务。

---

TL;DR

Simulink Agentic Toolkit 通过安全的 MCP 服务器将 LLM 编码代理与 MATLAB/Simulink 连接起来，提供丰富的工具和最佳实践技能，使代理能够安全地读取、编辑、测试和验证 Simulink 模型。这是一个真正的、生产级的加载项，面向希望实现 AI 辅助的基于模型设计的工程师。