10分钟上手MATLAB Agentic Toolkit:让AI Agent真正运行你的MATLAB代码
10分钟上手MATLAB Agentic Toolkit:让AI Agent真正运行你的MATLAB代码
MATLAB Agentic Toolkit 是 MathWorks 官方的开源工具包,它通过自动安装 MATLAB MCP Server 为你的 AI Agent 打通 MATLAB,并提供一套精心整理的"技能"(Skills),让 Claude Code、Copilot、Codex 等 AI 编码助手真正能运行、调试和测试你的 MATLAB 代码,而不是凭空猜测函数。
它能帮你做什么?🎯
普通 AI 助手写 MATLAB 代码时常见问题:虚构不存在的工具箱函数、遗漏新版本特性、走弯路。MATLAB Agentic Toolkit 解决两类问题:
- 连接:自动安装 MATLAB MCP Server,AI Agent 可以直接执行 MATLAB 代码、查看输出、诊断错误
- 技能:MathWorks 官方精选的 MATLAB 工作流与最佳实践,让 Agent 一步到位写出"地道"代码
💡 如果你主要用 Simulink,还需要另外安装 Simulink Agentic Toolkit,两者可一起安装。
环境要求与支持的 AI 助手
| 项目 | 要求 |
|---|---|
| MATLAB | R2021a 或更高版本 |
| AI 编码助手 | 支持 MCP 服务器和 Skills 即可,常见平台均会自动配置 |
受支持的 AI 助手包括:Claude Code、GitHub Copilot、OpenAI Codex、Gemini CLI、Amp。
快速安装:三步搞定 🚀
第 1 步:下载并安装安装器
从发行版页面下载安装器文件 agenticToolkitInstaller.mltbx,用 MATLAB 打开该文件,即可安装安装器附加功能。
第 2 步:运行安装命令
在 MATLAB 命令窗口执行:
setupAgenticToolkit("install")
安装时只勾选与你工作相关的技能组——技能加载得越精准,Agent 触发技能就越可靠。以后想加技能组,重跑一遍安装命令即可。
第 3 步:连接到现有 MATLAB 会话(可选)
默认情况下 Agent 每次会新建一个 MATLAB 会话。如果你希望它直接使用当前会话(保留工作区变量),在 MATLAB 命令窗口运行:
shareMATLABSession()
多个会话并存时,Agent 会连接到最近运行过该命令的会话。也可以把这条命令加进 MATLAB 启动脚本(Startup Script),一劳永逸。
使用 Claude Code 或 OpenAI Codex 的命令行用户,也可以通过 Agentic Toolkit Installer 在操作系统命令行中一次性完成全部配置,详见 Configuration_and_Troubleshooting.md。
一句话验证是否装好 ✅
直接问你的 AI Agent:
What version of MATLAB is running? List the installed toolboxes.
如果 Agent 能调用 MCP 工具并准确报出 MATLAB 版本和已安装工具箱列表,说明连接成功。
Agent 解锁的 5 大 MATLAB 能力 🛠️
安装完成后,你的 Agent 就拥有了由 MATLAB MCP Server 提供的这些"手":
| 你可以对 Agent 说 | 背后使用的工具 |
|---|---|
| "运行这段代码,把命令窗口输出给我" | evaluate_matlab_code |
| "运行这个 .m 程序" | run_matlab_file |
| "跑一下测试文件" | run_matlab_test_file |
| "帮我做静态代码分析" | check_matlab_code |
| "列出 MATLAB 版本和工具箱" | detect_matlab_toolboxes |
服务器还提供 matlab_coding_guidelines(编码规范)和 Live Script 格式规则两份参考资料,Agent 会按需查阅。
技能系统:让 Agent 成为某个领域的"老手" 📚
这是本工具包的灵魂。所有技能按技能组组织在 skills-catalog/ 目录下,每个技能包含一个 SKILL.md(工作流说明)和 manifest.yaml(元数据)。整体目录结构由根目录的 manifest.yaml 统一管理。
MATLAB 核心技能组
matlab-core:创建、调试、审查代码,管理产品安装——每个用户必装matlab-data-import-and-analysis:table / timetable 数据导入导出与分析matlab-software-development:写测试、现代化遗留代码、性能优化、打包工具箱matlab-programming、matlab-app-building等
以调试技能 skills-catalog/matlab-core/matlab-debug-code/SKILL.md 为例,它教会 Agent:遇到 Error using ...、Undefined function or variable 等报错时不盲目瞎猜,而是先静态分析、再运行时调试,逐层定位根因。
覆盖 20 个专业方向
技能组横跨 20 个领域:信号处理、AI 与统计、汽车、雷达、无线通信、计算金融、机器人、射频与混合信号……完整清单见 skills-catalog/README.md(简体中文版)。
想确保某个技能被加载?可以直接按名称手动触发,例如在 Claude Code 中输入 /matlab-write-tests。
更新与进阶配置 📝
更新工具包:下载最新安装器后用 MATLAB 打开,运行:
setupAgenticToolkit("update")
这会同时更新 MATLAB 与 Simulink 两个工具包的技能、配置和 MCP 服务器。
其他实用配置(详见 Configuration_and_Troubleshooting.md):
- 禁用数据收集:
setupAgenticToolkit("configure", DisableTelemetry=true) - 离线环境安装:通过
Offline=true参数与本地文件路径完成安装 - 手动配置模板:templates/README.md 提供了 Codex、Gemini、VS Code、Amp 各平台的 MCP 配置参考文件
安全提示 ⚠️
官方建议:执行重要操作前,务必审查 Agent 的每次工具调用,保持"人在环中"(Human in the Loop),确认调用完全符合预期后再放行。MCP Server 默认收集匿名使用数据,介意可参考上文方式关闭。
写在最后
MATLAB Agentic Toolkit 把"AI 会聊天"升级成了"AI 会干活"——10 分钟配置,你的 AI Agent 就能运行、测试、调试 MATLAB 代码,并带着 MathWorks 官方沉淀的工程经验帮你写代码。现在就去试试吧!
许可信息见 LICENSE.md。