matlab/simulink-agentic-toolkit

Simulink Agentic Toolkit

무엇인가요 – 대규모언어모델(LLM) 코딩 에이전트(Claude Code, Copilot, Codex, Gemini CLI, Sourcegraph Amp 등)가 Simulink® 모델을 읽고, 편집하고, 질의하고, 테스트하며, 검증할 수 있도록 해주는 MATLAB 기반 확장 기능입니다. 이는 에이전트를 MATLAB MCP Server(모델-컨텍스트-프로토콜 브리지)에 연결하고, 모델 기반 설계의 최선의 실천 방법을 인코딩한 스킬 카탈로그를 제공함으로써 가능합니다.

주요 구성 요소

• MCP 도구 – 에이전트가 Simulink 모델을 조작하기 위해 호출할 수 있는 즉시 사용 가능한 명령(model_overview, model_edit, model_test, …)
• 스킬 카탈로그 – 수십 개의 자체 포함형 스킬 정의(예: 모델 구축, SystemComposer 아키텍처, 검증, 코드 생성)로 각각은 필요한 툴박스를 설명하는 manifest.yaml을 포함합니다.
• 자동 설치기 – MATLAB 툴박스(agenticToolkitInstaller.mltbx)로 MCP 서버를 설치하고, 도구를 등록하며, 선택한 에이전트에 스킬을 추가하는 단일 명령(setupAgenticToolkit("install"))으로 가능합니다.
• 라이브러리 구성 – 설치된 MathWorks 블록 라이브러리 또는 사용자 정의 블록 라이브러리를 에이전트의 지식 기반에 노출하기 위한 도우미(satk.Configuration.setLibrary)

작동 방식

1. 설치기가 MATLAB MCP Server를 시작하고 실행 중인 MATLAB/Simulink 세션(shareMATLABSession)에 연결합니다.
2. 에이전트는 스킬 파일을 로드(전역 또는 프로젝트별)하고, 포함된 도메인 지식을 학습합니다.
3. 에이전트가 모델에 대해 작동이 필요할 때, MCP 도구를 호출합니다. 서버는 요청을 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')

헤드리스 또는 프록시 제한 환경에서는 위와 같이 프로그래밍 방식으로 툴박스를 설치할 수 있습니다.

수동 설정(완전한 제어를 원하는 경우)

• OS에 적합한 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 이슈 기반 프로세스를 통해 수락됩니다.