matlab/simulink-agentic-toolkit

Simulink Agentic Toolkit

是什麼 – 一個基於 MATLAB 的附加元件，讓大型語言模型（LLM）編碼代理（Claude Code、Copilot、Codex、Gemini CLI、Sourcegraph Amp 等）能讀取、編輯、查詢、測試與驗證 Simulink® 模型。它透過將代理連接到 MATLAB MCP Server（模型-上下文-協定橋接器）並提供一個編碼了模型-基礎設計最佳實務的 技能目錄 來達成此功能。

核心元件

• MCP 工具 – 代理可呼叫的即用型指令（model_overview、model_edit、model_test 等），用於操作 Simulink 模型。
• 技能目錄 – 數十個自我封裝的技能定義（例如：模型建構、SystemComposer 架構、驗證、程式碼產生），每個都包含一個 manifest.yaml 檔案，描述所需工具箱。
• 自動化安裝程式 – 一個 MATLAB 工具箱（agenticToolkitInstaller.mltbx），透過一個指令（setupAgenticToolkit("install")）即可安裝 MCP 伺服器、註冊工具，並將技能新增至所選代理中。
• 程式庫設定 – 幫助程式（satk.Configuration.setLibrary），用於將已安裝的 MathWorks 塊程式庫或自訂塊程式庫暴露給代理的知識庫。

運作方式

1. 安裝程式啟動 MATLAB MCP Server 並連接到正在執行的 MATLAB/Simulink 會話（shareMATLABSession）。
2. 代理載入技能檔案（全域或專案級），並學習其中包含的領域知識。
3. 當代理需要對模型執行操作時，它會呼叫一個 MCP 工具；伺服器將請求轉送至 MATLAB，MATLAB 執行相應的 Simulink API 呼叫並回傳結果。

支援平台 – 任何能消費 MCP 工具與技能的 LLM 編碼代理。倉儲列出對 Claude Code、GitHub Copilot、OpenAI Codex、Google Gemini CLI 與 Sourcegraph Amp 的驗證自動設定支援。

安裝（快速入門）

% 1. 從最新發行版本下載工具箱
matlab.addons.toolbox.installToolbox('agenticToolkitInstaller.mltbx')
% 2. 執行安裝程式（安裝 MCP 伺服器、註冊工具與技能）
setupAgenticToolkit('install')

對於無頭或代理受限環境，可如上所示透過程式設計方式安裝工具箱。

手動設定（如需完全控制）

• 下載適用於您作業系統的 matlab-mcp-server 二進位檔，並放置於 ~/.matlab/agentic-toolkits/bin/ 目錄中。
• 使用 ./matlab-mcp-server --setup-matlab 啟動伺服器，並在 MATLAB 控制台中執行 shareMATLABSession()。
• 克隆此倉儲，並將 tools/tools.json 擴充套件新增至伺服器的指令列中。
• 將技能目錄符號連結至 ~/.agents/skills/（README 中提供腳本）。

典型工作流程

% 為目前的 MATLAB 會話初始化工具包
addpath('~/.matlab/agentic-toolkits/simulink')
satk_initialize

% 開啟一個模型（隨 Simulink 一起提供的範例）
openExample('simulink_general/sldemo_househeatExample')

% 在您的 LLM 代理中提問：
%   "描述目前開啟模型的結構。"
% 代理將透過 MCP 呼叫 `model_overview`，並回傳層次結構描述。

代理可執行的操作（選定的 MCP 工具）

工具	能力
model_overview	列出子系統層次結構與主要連接
model_read	檢查塊參數、表示式與訊號流程
model_edit	新增/移除塊、連接訊號、設定參數
model_check	執行編輯時檢查（未連接端點、狀態問題）
model_test	執行 Gherkin 風格的驗證測試（需 Simulink Test）
model_query_params / model_resolve_params	擷取原始或解析後的參數值
model_read_diagnostics	從診斷檢視器中提取錯誤/警告

安全提示 – 所有工具呼叫應在執行前審查；任何修改模型或產生程式碼的操作都應保持人工在環。

授權 – 請參閱 LICENSE.md。MCP 伺服器的使用受 MathWorks 軟體授權協議約束，僅限單一 MATLAB/Simulink 使用者使用。

支援 – 在倉儲中開啟問題，或聯繫 MathWorks 技術支援。已停用拉取請求；貢獻透過常規的 GitHub 問題驅動流程接受。