
simulink-agentic-toolkit
让AI智能体真正会读会改Simulink模型
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1369
使用教程
环境要求
- 已安装 MATLAB(README 的 startup 示例以 R2026a 判断版本)
- 一个受支持的 AI 智能体:Claude Code、GitHub Copilot、Codex、Amp 或 Gemini CLI
- MATLAB MCP Server(自动安装会一并处理,手动模式需自行下载 release)
- 手动模式需一个正在运行、可执行 shareMATLABSession 的 MATLAB 会话
安装与启动步骤
-
1下载安装器
从 GitHub releases 下载最新版 agenticToolkitInstaller.mltbx 到本地。
-
2安装 add-on
打开下载的 mltbx 安装;若 Add-On 管理器打不开(无头机器、代理/杀毒、旧版 MATLAB),改用命令行安装。
matlab.addons.toolbox.installToolbox("agenticToolkitInstaller.mltbx") -
3运行自动安装
在 MATLAB 中执行自动安装:安装 MATLAB MCP Server、配置智能体、注册技能,可同时装 MATLAB 与 Simulink 工具包。
setupAgenticToolkit("install") -
4手动安装 MCP
仅手动模式需要:下载 MCP Server release 后执行此命令安装 MATLAB 工具箱;二进制需重命名为 matlab-mcp-server 放入 ~/.matlab/agentic-toolkits/bin/。
./matlab-mcp-server --setup-matlab -
5连接 MATLAB 会话
在正在运行的 MATLAB 命令行窗口中执行,让 MATLAB MCP Server 能连上该会话(satk_initialize 也会自动调用它)。
shareMATLABSession() -
6初始化工具包
每个 MATLAB 会话运行一次:把工具目录加入路径并运行 satk_initialize,后者会执行 validate_installation 自检。Windows 用 fullfile(getenv('USERPROFILE'),'.
addpath("~/.matlab/agentic-toolkits/simulink") satk_initialize -
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-session-mode | 否 | 手动模式下指定连接已有 MATLAB 会话 | --matlab-session-mode=existing |
--extension-file | 否 | 手动模式下加载 Simulink 工具包的 MCP 工具定义 | /path/to/simulink-agentic-toolkit/tools/tools.json |
MCPServerPath | 否 | MCP server 二进制装在非默认位置时显式指定路径 | //server/share/bin/matlab-mcp-server |
startup.m | 否 | 把初始化块写入该文件可让每次会话自动初始化 | if contains(version, 'R2026a') ... satk_initialize end |
如何确认成功
在 MATLAB 中运行 satk_initialize,其内部会调用 validate_installation 检查配置是否正确,无报错即表示安装成功。
常见问题
Q:打开 mltbx 时报 ERR_CERT_AUTHORITY_INVALID 或“Unable to open the
A:Add-On 管理器在无头机器、公司代理/杀毒或旧版 MATLAB 上常失败,改用命令行:matlab.addons.toolbox.installToolbox("agenticToolkitInstaller.mltbx")。
Q:如何卸载工具包?
A:在 MATLAB 中运行 setupAgenticToolkit("uninstall") 即可卸载。
Q:以前用 agent 驱动工作流装过,需要处理吗?
A:需要。必须先卸载那套自定义安装和全局配置,再按 Migrating from a Previous Installation 文档迁移。
Q:如何清除库配置?
A:全局配置用 satk.Configuration.clearConfig();项目本地配置可传项目路径,如 satk.Configuration.clearConfig("C:\\repo\\myProject"),两种方式都不可逆。
Q:MATLAB MCP Server 可以多人共享吗?
A:不可以。MCP server 只能按 MathWorks 软件许可协议配合 MATLAB 和 Simulink 使用,且不得多用户共享,如有集中部署需求需联系 MathWorks。
注意事项
- satk_initialize 每个 MATLAB 会话都要运行一次,可把初始化块加入 startup.m 自动执行。
- clearConfig 的两种形式都是破坏性操作且不可撤销。
- 手动下载的 MCP server 二进制要按平台重命名为 matlab-mcp-server(Windows 加 .exe)并放到 ~/.matlab/agentic-toolkits/bin/。
- 若还要对 MATLAB 使用智能体,可安装 MATLAB Agentic Toolkit,自动安装选项能一步装好两套工具包。
核心亮点
- 把Simulink建模经验封装成agent-skills技能,AI可直接调用而非凭空生成
- 提供MATLAB MCP Server,打通智能体与Simulink/MATLAB的实时操作通道
- 同时兼容Claude Code、Codex、GitHub Copilot多个主流智能体平台
不足之处
- 依赖MATLAB/Simulink商业授权,无许可证环境无法实际运行
- 项目以HTML为主,工具链生态和第三方集成广度仍待扩展
适用场景
- 用AI智能体批量分析现有Simulink模型结构并生成文档
- 在Claude Code中让AI辅助搭建和修改控制算法模型
- 通过MCP让智能体自动检查模型规范并定位建模错误
替代项目
matlab-mcp-server、modelcontextprotocol/servers
同类项目推荐
AI-Workflow-Hub-2000-
开源
复制即用,2000+现成N8N工作流模板,快速搞定AI自动化。
2000+ free N8N AI automation workflows. Discover, copy and use in your projects.
insights-lm-local-package
开源
本地私密版 NotebookLM,文档聊天、音频摘要全离线
Open-source, fully private and local alternative to NotebookLM. Chat with your docum···
deer-workflow
开源
用 TypeScript 编排图,灵活接入任意 AI Agent,搞定复杂工作流。
An open-source graph engineering runtime that keeps orchestration in TypeScript and ···
machinist
开源
把多个 AI 编码代理编排成自动流水线,从需求直达可合并代码
Open source software factory infrastructure for advanced AI coding workflows
watomatic
开源
忙时自动回消息,WhatsApp/Facebook 两不误
Auto reply app to enable auto reply for messengers like WhatsApp and Facebook Messen···
bops
开源
给每个 AI 员工配电脑邮箱电话,替你跑业务
Bops: a team of AI bots that run your business ops, each with its own computer, emai···
broccoli
开源
把 Linear 工单变成已合并的 PR,AI 帮你写代码提审
Broccoli turns Linear tickets into shipped PRs — powered by Claude and Codex, runni···
open-web-bridge
开源
让 AI 直接操控你已登录的真实 Chrome
Drive your real Chrome from any AI agent — logged-in sessions, real fingerprint, li···
terramate
开源
不改 Terraform 代码,就能编排多环境 IaC 并检测漂移
Open-source Infrastructure as Code (IaC) orchestration platform: GitOps workflows, o···