matlab/matlab-mcp-server

What it is

MATLAB MCP Server는 AI 기반 도구(Claude, GitHub Copilot, Codex 등)가 MATLAB을 시작하고, 코드를 실행하며, 환경에 대한 정보를 쿼리할 수 있도록 해주는 Go 기반의 경량 서비스입니다. 이 서비스는 AI 모델이 외부 "도구"를 호출하는 표준 방식인 **Model Context Protocol (MCP)**을 구현합니다.

Why it matters

많은 현대적 AI 어시스턴트들은 실제 과학적 또는 공학적 코드를 실행하기를 원합니다. MATLAB은 수치 계산, 신호 처리, 제어 시스템 및 시뮬레이션을 위한 지배적인 플랫폼입니다. MATLAB을 MCP 서버로 노출함으로써 개발자는 LLM 기반 워크플로 내에 MATLAB 기능을 직접 통합할 수 있습니다. 예를 들어, 다음과 같은 기능을 가진 챗봇을 만들 수 있습니다:

• 온디맨드 MATLAB 실행
• 사용자가 요청한 스크립트 실행
• 스크립트의 스타일 또는 오류 체크
• 결과를 채팅으로 반환 이는 대규모 언어 모델과 성숙한 독점 엔지니어링 환경 사이의 간극을 메워줍니다.

Core features (as described in the README)

Feature	What it does
Start / quit MATLAB	서버는 새로운 MATLAB 세션을 시작하거나 기존 세션에 연결할 수 있습니다 (--matlab-session-mode 사용).
Run arbitrary MATLAB code	evaluate_matlab_code는 코드 문자열을 평가하고, run_matlab_file는 .m 스크립트를 실행하며, run_matlab_test_file는 MATLAB 단위 테스트 파일을 실행합니다.
Static analysis	check_matlab_code는 읽기 전용 린트 스타일 체크를 수행하여 스타일, 지원 중단된 함수, 성능 힌트 등을 보고합니다.
Tool discovery	detect_matlab_toolboxes는 설치된 툴박스와 해당 버전을 보고합니다.
Resources	AI가 더 나은 코드를 생성하기 위해 읽을 수 있는 MCP 리소스로 코딩 가이드라인 문서(예: MATLAB 코딩 표준)를 제공합니다.
Custom extensions	사용자는 추가 MCP 도구를 정의하는 JSON 파일(--extension-file)을 제공할 수 있습니다.
Configurable startup	초기 작업 폴더, 디스플레이 모드(desktop vs nodesktop), 로그 위치/수준 및 텔레메트리 제어 옵션이 있습니다.
Cross‑platform binaries	Windows, Linux, macOS (Intel & Apple‑silicon)용 사전 빌드된 바이너리와 소스 빌드를 위한 go install 명령어를 제공합니다.

Who would use it

• AI 어시스턴트 개발자: Claude, Copilot 또는 기타 LLM 기반 제품에 MATLAB 기능을 추가하려는 개발자.
• 연구원: MATLAB에서 시뮬레이션 또는 데이터 분석 파이프라인을 실행해야 하는 자율 에이전트를 구축하는 연구원.
• 팀: 이미 MATLAB 라이선스를 보유하고 있으며, 자체 래퍼를 작성하지 않고 기능을 프로그래밍 방식으로 노출하고자 하는 팀.

How to get started (quick‑start)

1. MATLAB R2021a 이상을 설치하고 matlab이 시스템 PATH에 있는지 확인하세요.
2. OS에 맞는 바이너리를 다운로드하거나 go install …로 빌드하세요.
3. AI 도구에 서버를 등록합니다:
   • Claude Code – claude mcp add --transport stdio matlab -- /path/to/matlab-mcp-server
   • Claude Desktop – 제공된 .mcpb 번들을 설치합니다.
   • VS Code (Copilot) – .vscode/mcp.json에 바이너리를 가리키는 matlab 항목을 추가합니다.
   • Codex – codex mcp add matlab -- /path/to/matlab-mcp-server.
4. (선택 사항) --initial-working-folder 또는 --matlab-display-mode=nodesktop과 같은 인수를 전달하여 동작을 맞춤 설정합니다.
5. AI 기반 워크플로에서 노출된 도구(run_matlab_file, check_matlab_code 등)를 사용합니다.

Limitations & considerations

• 라이선스 제한 – 서버는 유효한 MathWorks 라이선스 하에서만 사용할 수 있으며 다중 사용자 공유용이 아닙니다.
• 텔레메트리 – 기본적으로 익명의 사용 데이터가 MathWorks로 전송됩니다. --disable-telemetry=true로 비활성화할 수 있습니다.
• 그래픽 명령 – nodesktop 모드에서도 GUI 창을 여는 명령(예: uifigure)은 호스트 머신에 팝업됩니다.
• 기존 세션 모드 – shareMATLABSession()를 실행한 실행 중인 MATLAB 인스턴스가 필요합니다.

---

위의 모든 정보는 저장소의 README에서 직접 가져왔습니다.