matlab/simulink-agentic-toolkit

The Simulink Agentic Toolkit gives your AI agent both the tools and the expertise to work effectively with Simulink and Model-Based Design.

Simulink Agentic Toolkit이란

Simulink Agentic Toolkit은 LLM(대규모 언어 모델) 기반 코딩 에이전트(Claude Code, GitHub Copilot, OpenAI Codex, Gemini CLI, Sourcegraph Amp 등)가 Simulink 모델과 직접 상호 작용할 수 있게 해주는 MATLAB 기반 애드온입니다. 이는 다음을 통해 수행됩니다:

  1. MATLAB MCP(Model-Context-Protocol) 서버 실행 – MATLAB/Simulink 함수를 에이전트가 호출할 수 있는 "도구"로 노출하는 작은 브리지.
  2. "스킬" 카탈로그 제공 – 모델 기반 설계 모범 사례(구축, 테스트, 요구사항, 코드 생성 등)를 인코딩하는 재사용 가능한 도메인별 프롬프트.
  3. 설치 프로그램 패키징 – MCP 서버를 자동으로 설정하고, 선택한 에이전트에 스킬을 등록하며, MATLAB 경로를 구성합니다.

요컨대, 이 툴킷은 LLM에게 인간 엔지니어처럼 Simulink 모델을 읽고, 편집하고, 조회하고, 테스트하고, 검증할 수 있는 지식(스킬)과 능력(MCP 도구)을 제공합니다.


주요 기능

기능 에이전트에게 제공되는 것 중요한 이유
MCP 도구 model_read, model_edit, model_test, model_check, model_query_params 등 수동 스크립팅 없이 라이브 Simulink 세션 내에서 에이전트가 구체적인 작업을 수행할 수 있게 합니다.
스킬 카탈로그 핵심 MBD, 시스템 엔지니어링, 검증, 시뮬레이션, 제어, 코드 생성, 실시간 테스트 등을 다루는 12개 이상의 스킬 그룹. MISRA 검사, Gherkin 스타일 테스트와 같은 업계 표준 워크플로우를 인코딩하여 에이전트가 환각 없이 모범 사례를 따르도록 합니다.
자동 설치 프로그램 (agenticToolkitInstaller.mltbx) MCP 서버, 툴박스 경로, 스킬 등록을 원클릭으로 설정. 제거/업데이트도 지원. 엔지니어가 에이전트 지원 모델링을 시도하는 데 대한 장벽을 낮춥니다.
크로스 에이전트 지원 Claude Code, Copilot, Codex, Gemini CLI, Sourcegraph Amp와 호환(모두 검증됨). 팀이 선호하는 LLM 코딩 어시스턴트를 유연하게 사용할 수 있습니다.
사용자 지정 라이브러리 인덱싱 satk.Configuration.setCustomLibraries는 사용자 정의 Simulink 블록 라이브러리에서 지식 베이스를 구축합니다. 에이전트가 독점 블록을 이해하고 생성된 모델에서 재사용할 수 있게 합니다.
보안 우선 설계 도구 호출에 대한 인간 검토가 필요. MCP 사양에는 사용자 상호 작용 및 보안 지침이 포함됩니다. 중요한 모델에 대한 우발적 파괴적 변경을 방지합니다.

일반적인 워크플로우

  1. 제공된 .mltbx 설치 프로그램으로 툴킷을 설치합니다(또는 MCP 서버를 수동으로 설정).
  2. setupAgenticToolkit("install")을 실행합니다:
    • MCP 서버 바이너리를 설치.
    • MATLAB 경로에 툴킷을 추가.
    • 선택한 LLM 에이전트에 스킬 카탈로그를 등록.
  3. Simulink가 로드된 MATLAB 세션을 시작하고 satk_initialize를 호출합니다(세션당 한 번). 이렇게 하면 세션이 MCP 서버와 공유됩니다.
  4. LLM에게 작업을 요청합니다. 예:
    "플랜트 모델에 PID 컨트롤러를 추가하고 Kp, Ki, Kd를 튜닝하세요."
    
    에이전트는 적절한 스킬을 읽은 다음 MCP를 통해 model_edit(블록 추가, 파라미터 설정)와 model_test(Gherkin 테스트 실행)를 호출합니다.
  5. 결과를 검증합니다 – 툴킷은 진단, 모델 계층 구조 또는 시뮬레이션 출력을 인간이 검토할 수 있도록 표시합니다.

대상 사용자

대상 이점
제어/메카트로닉스 엔지니어 프로토타입 반복이 빨라짐. LLM이 높은 수준의 사양을 기반으로 컨트롤러 블록을 생성하거나 수정할 수 있습니다.
시스템 엔지니어 스킬을 통한 System Composer 아키텍처 업데이트 및 요구사항 추적 자동화.
검증 팀 Gherkin 스타일 테스트 하니스를 생성하고 Model Advisor 검사를 실행하며 규정 준수 보고서를 자동으로 생성합니다.
도구 개발자/연구자 LLM 기반 모델 기반 설계의 구체적인 예. 스킬 카탈로그를 확장하거나 새로운 에이전트를 실험할 수 있습니다.

제한 사항 및 고려 사항

  • MATLAB R2023a 이상 및 Simulink가 필요합니다. 오픈 소스 Octave 환경에서는 실행되지 않습니다.
  • 일부 도구(예: model_test)에는 Simulink Test와 같은 추가 MathWorks 제품이 필요합니다.
  • MCP 서버는 단일 사용자 라이선스입니다. 여러 사용자가 서버를 공유하면 MathWorks 라이선스를 위반합니다.
  • 툴킷은 환각을 방지하기 위해 노력하지만, 특히 안전이 중요한 모델에서는 인간의 감독이 여전히 필수적입니다.

시작하기(빠른 시작)

% 1. 애드온 설치(먼저 .mltbx 다운로드)
matlab.addons.toolbox.installToolbox('agenticToolkitInstaller.mltbx')

% 2. 자동 설정 실행
setupAgenticToolkit('install')

% 3. 현재 MATLAB 세션 초기화
satk_initialize

% 4. 데모 모델을 열고 에이전트에게 질문
openExample('simulink_general/sldemo_househeatExample')
% LLM 채팅 창에서:
%   "현재 열려 있는 모델의 구조를 설명하세요."

추가 정보

  • 전체 문서 – Configuration_and_Troubleshooting.md, skills-catalog/README.md.
  • 라이선스 – LICENSE.md 참조(MathWorks 독점 라이선스).
  • 버그 보고 – 내장된 filing-bug-reports 스킬을 사용하거나 GitHub에서 이슈를 여십시오.
  • 연구 미리 보기 – slAgenticTaskExplorer는 에이전트가 수행할 수 있는 다단계 작업을 보여줍니다.

TL;DR

Simulink Agentic Toolkit은 안전한 MCP 서버를 통해 LLM 코딩 에이전트를 MATLAB/Simulink에 연결하여, 에이전트가 Simulink 모델을 안전하게 읽고, 편집하고, 테스트하고, 검증할 수 있도록 풍부한 도구와 모범 사례 스킬을 제공합니다. AI 지원 모델 기반 설계를 원하는 엔지니어를 위한 진정한 프로덕션 등급의 애드온입니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트