一句话让 AI 写 Simulink：Simulink Agentic Toolkit 落地笔记

> 整理：个人技术笔记（基于 MathWorks 官方 Simulink Agentic Toolkit + 自身实操）

> 适用环境：MATLAB R2023a+ / Simulink；本文实测环境为 **MATLAB R2026a (Update 3) + Simulink 26.1 / Windows 11**

> 原始资料：MathWorks 官方仓库与社区文章（公众号「快乐的宇航boy」），此处仅作个人化重写与原创补充

---

## 一句话结论

Simulink Agentic Toolkit 本质是把「MATLAB/Simulink 的建模、仿真、诊断能力」封装成一组 **MCP 工具**，让支持 MCP 的编码 Agent（通义灵码、TRAE、Claude Code 等）能直接驱动 MATLAB 干活。

- **装**：优先走官方 setupAgenticToolkit("install") 一键装；github 抽风时用手动兜底。

- **接**：官方只内置了国外 Agent 的一键配置，国内免费 Agent（通义灵码 / TRAE）改一段 mcp.json 即可接上。

- **验**：我用最小 Simulink 模型（MCP_TestModel）实跑了一遍端到端连通性，**结果 PASS、0 错误**（详见「试用结果展示」）。

> 边界提醒：该工具对模型能力依赖很强。复杂建模/编辑建议用高能力模型（Claude Opus/Sonnet、GPT-5、Gemini Pro）；轻量模型在「建模型、改结构」这类任务上可靠性明显下降。日常连通性验证用国内免费 Agent 完全够，但别指望它独立完成严肃的工程建模。

---

## 环境要求与能力边界

**系统要求**

- MATLAB R2023a 或更高版本 + Simulink ，某宝购买教育版账号很便宜，agent需要正版运行。

- 可选工具箱：Simulink Test（model_test 必需）、System Composer、Requirements Toolbox、Simscape、Stateflow

**模型能力建议（实测结论）**

- 高能力模型：多步推理、工具调用、编码能力强，复杂工作流可靠。

- 轻量/低能力模型：模型构建、复杂结构编辑任务可靠性低，不建议用于正式工程。

官方仓库（自行按需阅读或让 AI 辅助安装）：

https://github.com/matlab/simulink-agentic-toolkit

---

## 安装与配置

### 自动配置（官方推荐）

1. 下载 agenticToolkitInstaller.mltbx 并双击安装

下载：https://github.com/matlab/simulink-agentic-toolkit/releases

> 社区 tip：网上搜也可找到安装包，github 不稳时可用此渠道。

2. MATLAB 中执行：

```matlab

setupAgenticToolkit("install")

```

选择 3 (Both)，确认 Proceed? [Y/n]: y。安装器会下载 MATLAB MCP Server、MATLAB / Simulink Agentic Toolkit，并写入 marketplace.json。

3. 安装中若第 1 步报 Failed to reach github.com ... timed out：通常是 github 连接不稳或官方更新了 MCP 包地址。**多试几次即可**，也可单独下载 MATLABMCPServerToolbox.mltbx 双击安装兜底：

https://github.com/matlab/matlab-mcp-server/releases

4. 装完后 MATLAB 会询问是否配置 Agent。官方内置 Claude Code / GitHub Copilot / Codex / Amp / Gemini CLI 等**国外 Agent**，有则一键配置；没有就跳过，国内 Agent 见后文。

>PS: 可能需要科学上网

**成功日志（参考）**

```

>> setupAgenticToolkit("install")

Detected: Platform: Windows x86_64 MATLAB: R2023a

Enter selection: 3

Proceed? [Y/n]: y

MCP server binary already at v0.11.0, skipping download.

MATLAB MCP Server Toolbox already installed (skipping).

Downloading MATLAB Agentic Toolkit 2026.06.18... -> ~/.matlab/agentic-toolkits/matlab

Downloading Simulink Agentic Toolkit 2026.06.24... -> ~/.matlab/agentic-toolkits/simulink

Merged marketplace.json written (23 plugins).

Artifacts installed.

```

**典型报错（github 不稳）**

```

Error using setup.fetchLatestRelease

Failed to reach github.com for matlab/matlab-mcp-core-server:

The connection to URL '.../releases/latest' timed out after 30.000 seconds.

```

### 手动配置（github 不稳时的兜底）

1. 下载并安装 MATLABMCPServerToolbox.mltbx（同上 releases 地址）。

2. 下载 agenticToolkitInstaller.mltbx 双击安装（不装也不影响运行，建议装）。

3. 解压 agentic-toolkits.zip 到本地目录，修改其中 config.json：

- matlabMcpServer 路径 → 自己电脑上 MCP 工具箱安装地址（Manage Add-Ons 里可定位，JSON 内用双反斜杠 \\）。

- MATLAB 安装路径/版本 → 自己电脑实际路径（双反斜杠）。

### 初始化（每次启动自动生效）

把初始化脚本写进 startup.m，避免每次手敲：

```

C:\Users\<你的用户名>\Documents\MATLAB\startup.m

```

启动后 MATLAB 自动执行 satk_initialize，出现成功信息即就绪。

---

## 国内免费 Agent 接入

国外大模型贵，验证类任务用国内免费 Agent 足够。以 **workbuddy** 为例，在连接器的 MCP 配置里粘贴：

```json

{

"mcpServers": {

"simulink": {

"command": "C:\\Users\\XXX\\.matlab\\agentic-toolkits\\bin\\matlab-mcp-server.exe",

"args": [

"--matlab-session-mode=existing",

"--extension-file=C:\\Users\\XXX\\.matlab\\agentic-toolkits\\simulink\\tools\\tools.json"

]

}

}

}

```

> 第 4、7 行的 XXX 换成你自己的用户目录；并先在 MATLAB 完成 satk_initialize 初始化，再启动 IDE 或在 MCP 面板刷新。TRAE 配置同理，粘贴同一段 JSON 即可。

---

## 试用结果展示（实测）

下面是我本机**实跑**的一次验证。

由于写了一个复杂的模型开发规范，所以生成的很慢，大量时间在自检和测试：

---

## 官方 setup 函数速查

setupAgenticToolkit 除安装外，还管配置/状态/更新/卸载（详见 GettingStarted.mlx）：

```matlab

setupAgenticToolkit("install") % 交互式安装

setupAgenticToolkit("install", Toolkit="simulink", Prompt=false) % CI 非交互安装

setupAgenticToolkit("configure") % 配置 Agent

setupAgenticToolkit("configure", Agents="claude-code", Scope="global", Prompt=false)

setupAgenticToolkit("status") % 查看已装/已配

setupAgenticToolkit("update") % 检查并应用更新

setupAgenticToolkit("uninstall") % 卸载

setupAgenticToolkit("install", Toolkit="simulink", Source="/path/to/simulink-agentic-toolkit") % 本地源码装

```

常用选项：InstallRoot（安装根，默认 ~/.matlab/agentic-toolkits）、SessionMode（auto/existing/new）、SkillGroups、AgentCLI。完整见 help setupAgenticToolkit。

---

## 参考链接

- https://github.com/matlab/simulink-agentic-toolkit

- https://blogs.mathworks.com/simulink/2026/04/17/simulink-agentic-toolkit/

- https://www.mathworks.com/products/simulink-agentic-toolkit.html