企业官网建设流程全解析

• 人工智能
• AI 技能
• AI 插件
• MCP 服务

Simulink Agentic Toolkit是 MathWorks 推出的 AI 智能体工具箱，它为 AI 编码智能体（如 Claude Code、Copilot、Codex 等）提供读取、构建、编辑和测试 Simulink 模型所需的MCP 工具与模型驱动设计（MBD）最佳实践技能，让智能体不再"凭空想象"，而是像资深 Simulink 用户一样高效工作。本文是一份面向新手的快速上手指南，带你三步完成安装并连接你的 AI 智能体。

一、Simulink Agentic Toolkit 是什么？

在动手安装之前，先花 30 秒理解它的工作原理：

┌───────────┐ ┌───────────┐ ┌──────────┐ │ AI Agent │◄─MCP─►│MCP Server │◄─────►│ MATLAB / │ │ (Claude, │ │ (MATLAB │ │ Simulink │ │ Codex) │ │ MCP Core) │ └──────────┘ └───────────┘ └───────────┘ ▲ │ 读取 ┌─────┴─────┐ │ Skills │ （MBD 最佳实践知识） └───────────┘

你的 AI 智能体通过MCP（Model Context Protocol）协议与 MATLAB MCP Server 通信，由它连接运行中的 MATLAB 与 Simulink 会话；同时智能体还会读取工具箱内置的技能（Skills），获得领域知识。工具箱为此提供了两大能力：

• MCP 工具：覆盖模型的读取、编辑、查询、测试与检查
• 智能体技能：涵盖建模、仿真、测试、需求管理、合规检查、代码生成等 MBD 最佳实践

完整的工具与技能清单可参考 skills-catalog/README.md 和 README.md。

二、安装前准备：环境要求清单

请对照下表确认你的环境已就绪：

💡 小提示：如果你同时想用 AI 智能体处理 MATLAB 脚本相关任务，建议一并安装 MATLAB Agentic Toolkit，自动安装流程可以一步到位装好两者。

三、三步安装：一键配置你的 AI 智能体

推荐路径是自动化安装，整个过程大约 10 分钟。

第 1 步：下载安装器

从项目 Releases 下载agenticToolkitInstaller.mltbx文件。若直接打开文件时 Add-On Manager 无法启动（常见于无界面服务器、企业代理或杀毒软件环境，可能提示ERR_CERT_AUTHORITY_INVALID），可在 MATLAB 中用命令行方式安装：

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

第 2 步：运行一键安装

安装完成后，在 MATLAB 命令窗口执行：

setupAgenticToolkit("install")

安装器会自动完成以下工作：

1. 下载并安装MATLAB MCP Server（连接智能体与 MATLAB 的桥梁）
2. 配置你的 AI 智能体（写入 MCP 配置、注册 Simulink 技能）
3. 支持将智能体配置为仅当前项目或全局生效

各平台配置写入位置略有不同（如 Claude Code 写入~/.claude.json，Codex 写入~/.codex/config.toml），详细对照表见 Configuration_and_Troubleshooting.md。

第 3 步：在 MATLAB 会话中初始化工具箱

MCP Server 需要连接到一个正在运行的 MATLAB 会话。在每个 MATLAB 会话中执行：

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

Windows 下请将addpath参数改为：

addpath(fullfile(getenv('USERPROFILE'), '.matlab', 'agentic-toolkits', 'simulink'))

initialize 入口 satk_initialize.p 一次完成三件事：

1. 将工具箱的工具目录加入 MATLAB 路径
2. 调用shareMATLABSession，让 MCP Server 连接到当前 MATLAB 会话
3. 运行 validate_installation.p 校验安装是否完整

如需每个会话自动执行，可将上述命令写入 MATLAB 的startup.m（README 中提供了带版本判断的完整代码块）。

四、验证安装：确认 AI 智能体已"通电"

安装完成后，建议从两端各验证一次：

MATLAB 端：satk_initialize会自动触发 validate_installation.p 执行 6 项检查（MATLAB 版本、Simulink 许可、工具入口、包解析、MCP 服务器二进制、MCP 连通性），全部通过时显示PASS，即代表 MCP 工具已就绪。

智能体端：

你应该能看到matlabMCP Server 及其工具（model_overview、model_read、model_edit、model_query_params、model_test等），技能列表中则能看到building-simulink-models、testing-simulink-models等 MBD 技能。更详细的验证方法见 docs/faq.md。

五、快速体验：让智能体读懂你的第一个模型

打开一个 Simulink 示例模型：

openExample('simulink_general/sldemo_househeatExample')

然后对你的 AI 智能体说一句：

Describe the structure of the currently open model.（描述当前打开模型的结构）

智能体会调用model_overview工具，为你梳理模型的子系统层级、接口与主要组件连接方式。

安装完成后，你的智能体可直接调用 9 个 MCP 工具（完整定义见 tools/tools.json）：

六、常见问题速查

遇到"卡壳"时，先查这张表，大多数问题都能 1 分钟解决：

完整故障排查清单见 Configuration_and_Troubleshooting.md 的 Troubleshooting 章节。

七、进阶操作：更新、卸载与库配置

更新后记得重新运行satk_initialize并重启智能体会话。

此外，工具箱还内置了Toolbox Library 知识库（位于 toolbox-kb/），覆盖 Simulink、Simscape、Aerospace Blockset 等上百个工具箱，可为智能体提供块级知识。可通过以下命令激活：

satk.Configuration.setLibrary('all') % 激活所有已安装工具箱的知识库

写在最后

至此，你已经完成了 Simulink Agentic Toolkit 的全部安装与验证工作：智能体拥有了操作 Simulink 模型的"双手"（MCP 工具）和资深工程师的"经验"（MBD 技能）。接下来，打开任意一个 Simulink 模型，试着让智能体帮你加一个子系统、修一个未连接端口，或者为模型写一组测试——10 分钟投资，换的是 AI 驱动建模工作流的长期回报。

⚠️ 安全提示：运行前请始终审查智能体的工具调用，重要操作保持"人类在环"（Human in the Loop）。

• 人工智能
• AI 技能
• AI 插件
• MCP 服务