simulink-agentic-toolkit

环境要求

• 已安装 MATLAB（README 的 startup 示例以 R2026a 判断版本）
• 一个受支持的 AI 智能体：Claude Code、GitHub Copilot、Codex、Amp 或 Gemini CLI
• MATLAB MCP Server（自动安装会一并处理，手动模式需自行下载 release）
• 手动模式需一个正在运行、可执行 shareMATLABSession 的 MATLAB 会话

安装与启动步骤

1. 1下载安装器

   从 GitHub releases 下载最新版 agenticToolkitInstaller.mltbx 到本地。

2. 2安装 add-on

   打开下载的 mltbx 安装；若 Add-On 管理器打不开（无头机器、代理/杀毒、旧版 MATLAB），改用命令行安装。

   matlab.addons.toolbox.installToolbox("agenticToolkitInstaller.mltbx")

   复制

3. 3运行自动安装

   在 MATLAB 中执行自动安装：安装 MATLAB MCP Server、配置智能体、注册技能，可同时装 MATLAB 与 Simulink 工具包。

   setupAgenticToolkit("install")

   复制

4. 4手动安装 MCP

   仅手动模式需要：下载 MCP Server release 后执行此命令安装 MATLAB 工具箱；二进制需重命名为 matlab-mcp-server 放入 ~/.matlab/agentic-toolkits/bin/。

   ./matlab-mcp-server --setup-matlab

   复制

5. 5连接 MATLAB 会话

   在正在运行的 MATLAB 命令行窗口中执行，让 MATLAB MCP Server 能连上该会话（satk_initialize 也会自动调用它）。

   shareMATLABSession()

   复制

6. 6初始化工具包

   每个 MATLAB 会话运行一次：把工具目录加入路径并运行 satk_initialize，后者会执行 validate_installation 自检。Windows 用 fullfile(getenv('USERPROFILE'),'.

   addpath("~/.matlab/agentic-toolkits/simulink")
   satk_initialize

   复制

7. 7注册技能软链

   仅针对从 ~/.agents/skills/ 发现技能的平台：把 skills-catalog/ 下各非空技能组内的 SKILL.md 目录软链过去。

   mkdir -p ~/.agents/skills
   for group in model-based-design-core model-based-system-engineering verification-validation-and-test simulink-simulation simulink-modeling control-systems simulink-environment-fundamentals signal-processing physical-modeling code-generation real-time-simulation-and-testing; do
     for skill in /path/to/simulink-agentic-toolkit/skills-catalog/$group/*/; do
       ln -s "$skill" ~/.agents/skills/$(basename "$skill")
     done
   done

   复制

关键配置

如何确认成功

在 MATLAB 中运行 satk_initialize，其内部会调用 validate_installation 检查配置是否正确，无报错即表示安装成功。

常见问题

注意事项

• satk_initialize 每个 MATLAB 会话都要运行一次，可把初始化块加入 startup.m 自动执行。
• clearConfig 的两种形式都是破坏性操作且不可撤销。
• 手动下载的 MCP server 二进制要按平台重命名为 matlab-mcp-server（Windows 加 .exe）并放到 ~/.matlab/agentic-toolkits/bin/。
• 若还要对 MATLAB 使用智能体，可安装 MATLAB Agentic Toolkit，自动安装选项能一步装好两套工具包。