MATLAB MCP Core Server

MATLAB MCP 서버

English • Español • 日本語 • 한국어 • 简体中文

[!WARNING] v0.11.0부터 MATLAB MCP Core Server는 MATLAB MCP Server로 이름이 변경되었습니다. 이 변경 후 최신 버전의 서버를 사용하려면 설정을 업데이트해야 합니다.

변경 사항	필요한 조치
바이너리 이름 새 형식: matlab-mcp-server-<os>-<arch>[.exe] 예: matlab-mcp-server-windows-x64.exe	AI 애플리케이션의 구성 설정(일반적으로 .json 파일)에서 바이너리 이름을 업데이트하세요.
툴박스 업데이트 및 이름 변경: MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox	./matlab-mcp-server --setup-matlab을(를) 실행하여 최신 버전의 툴박스를 설치하세요. 기존 MATLAB 세션에 연결하려면 툴박스가 필요합니다. 자세한 내용은 인수 섹션의 matlab-session-mode을(를) 참조하세요.
저장소 URL github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	없음. GitHub에서 자동으로 리디렉션됩니다.
MCP 번들 업데이트 및 이름 변경: matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb	v0.11.0 이전에 MATLAB MCP 번들을 사용하여 Claude Desktop에 MCP 서버를 설치한 경우, 먼저 서버를 제거한 다음 최신 릴리스 페이지에서 새 matlab-mcp-server.mcpb 번들을 다운로드하여 서버를 다시 설치하세요. 자세한 내용은 Claude Desktop 섹션을 참조하세요.
Go 모듈 github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Go 프로젝트에서 MATLAB MCP Core Server 모듈을 사용하는 경우, go.mod 및 import 선언에서 모듈 이름을 업데이트하세요.

MathWorks®의 공식 MATLAB MCP 서버를 사용하여 AI 애플리케이션으로 MATLAB®을 실행하세요. MATLAB MCP 서버를 통해 AI 애플리케이션은 다음을 수행할 수 있습니다.

• MATLAB 시작 및 종료.
• MATLAB 코드 작성 및 실행.
• MATLAB 코드의 스타일 및 정확성 평가.

에이전트가 MATLAB 및 Simulink를 사용하는 데 도움을 주려면 MATLAB Agentic Toolkit (GitHub) 및 Simulink Agentic Toolkit (GitHub)의 스킬을 사용할 수 있으며, 이를 통해 이 MCP 서버를 자동으로 설치할 수도 있습니다.

목차

• 설정
  • Claude Code
  • Claude Desktop
  • Visual Studio Code의 GitHub Copilot
  • Codex
• 인수
• 도구
• 리소스
• 데이터 수집
• 보안 고려 사항
• 라이선스 및 사용
• 지원 문의

설정

1. MATLAB (MathWorks) R2021a 이상을 설치하고 시스템 PATH에 추가하세요. MATLAB MCP 서버는 최근 5년간의 MATLAB 릴리스를 지원합니다.

2. 이 서버는 모델 컨텍스트 프로토콜을 사용하는 모든 AI 애플리케이션을 지원합니다. Claude Desktop용 MATLAB MCP 서버를 설정하려면 Claude Desktop 지침으로 건너뛰세요. 다른 애플리케이션용으로 서버를 설정하려면 다음 지침을 따르세요.

   • Windows 또는 Linux의 경우, 최신 릴리스 다운로드. (또는 소스에서 빌드할 수 있습니다. Go를 설치하고 go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest을(를) 사용하여 바이너리를 빌드하세요.)

   • macOS의 경우, 먼저 터미널에서 다음 명령을 실행하여 최신 릴리스를 다운로드하세요.

     • Apple silicon 프로세서의 경우, 다음을 실행하세요.

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
       

     • Intel 프로세서의 경우, 다음을 실행하세요.

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
       

     그런 다음 다운로드한 바이너리에 실행 권한을 부여하여 MATLAB MCP 서버를 실행할 수 있도록 합니다.

     chmod +x ~/Downloads/matlab-mcp-server
     

3. AI 애플리케이션에 MATLAB MCP 서버를 추가하세요. AI 애플리케이션의 설명서에서 MCP 서버 추가 지침을 찾을 수 있습니다. Claude Code®, Claude Desktop® 및 Visual Studio® Code의 GitHub Copilot 사용에 대한 예시 지침은 아래를 참조하세요. 선택적 인수를 지정하여 서버를 사용자 지정할 수 있습니다.

Claude Code

터미널에서 다음을 실행하되, 설정 과정에서 획득한 서버 바이너리의 전체 경로를 입력해야 합니다.

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary

선택적 인수를 지정하여 서버를 사용자 지정할 수 있습니다. Claude Code의 옵션과 서버 인수 사이의 -- 구분 기호에 유의하세요.

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

Claude Code에서 MCP 서버를 추가하는 방법에 대한 자세한 내용은 로컬 stdio 서버 추가 (Claude Code)를 참조하세요. 나중에 서버를 제거하려면 다음을 실행하세요.

claude mcp remove matlab

Claude Desktop

MATLAB MCP 서버 번들을 사용하여 Claude Desktop에 MATLAB MCP 서버를 설치합니다.

1. Claude Desktop에 Filesystem 확장을 설치하여 Claude가 시스템의 파일을 읽고 쓸 수 있도록 허용합니다. Claude Desktop에서 설정 > 확장 > 확장 찾아보기를 클릭합니다. Anthropic에서 개발한 Filesystem 확장을 검색하고 설치를 클릭합니다. MCP 서버가 액세스할 수 있도록 허용할 폴더를 지정한 다음, 비활성화됨 버튼을 토글하여 Filesystem 확장을 활성화합니다.

2. 최신 릴리스 페이지에서 MATLAB MCP 서버 번들 matlab-mcp-server.mcpb을(를) 다운로드합니다.

3. MATLAB MCP 서버 번들을 데스크톱 확장으로 설치하려면 다운로드한 matlab-mcp-server.mcpb 파일을 더블 클릭하고 Claude Desktop에서 설치를 클릭합니다. (또는 Claude에서 파일 메뉴 > 설정 > 확장 > 고급 설정 > 확장 설치로 이동하여 matlab-mcp-server.mcpb 파일을 선택합니다. 설치를 클릭합니다).

MATLAB MCP 서버의 동작을 사용자 지정하려면 설정 > 확장 > 구성으로 이동하여 서버의 인수를 수정할 수 있습니다.

Visual Studio Code의 GitHub Copilot

VS Code 작업 영역에서 .vscode/mcp.json 파일을 만듭니다. 다음 JSON을 삽입하되, 설정 과정에서 획득한 서버 바이너리의 전체 경로와 인수를 지정해야 합니다. 그런 다음 파일을 저장합니다. (Windows에서는 경로에 이스케이프 문자로 추가 슬래시가 필요합니다.)

{
    "servers": {
        "matlab": {
            "type": "stdio",
            "command": "C:\\fullpath\\to\\matlab-mcp-server-windows-x64.exe",
            "args": []
        }
    }
}

VS Code에서 MCP 서버를 사용하는 방법에 대한 자세한 내용은 VS Code에서 MCP 서버 추가 및 관리 (VS Code)를 참조하세요.

Codex

터미널에서 다음을 실행하되, 설정 과정에서 획득한 서버 바이너리의 전체 경로를 입력해야 합니다.

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary

선택적 인수를 지정하여 서버를 사용자 지정할 수 있습니다. 예를 들면 다음과 같습니다.

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

[!NOTE] Windows 사용자: Codex는 MATLAB 및 Simulink를 실행하는 데 필요한 WINDIR 환경 변수를 전달하지 않습니다(#32 참조).

변수를 추가하려면 C:\Users\<username>\.codex\config.toml에서 Codex 구성 파일을 열고 [mcp_servers.matlab] 섹션에 env_vars = ["WINDIR"]을(를) 추가하세요.

[mcp_servers.matlab]
command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

인수

다음 방법 중 하나로 인수를 지정하여 서버 동작을 사용자 지정하세요.

• AI 애플리케이션의 구성 설정(일반적으로 .json 파일)에 인수를 삽입합니다.
• 서버를 시작할 때 명령줄 인터페이스(CLI) 플래그로 인수를 입력합니다.
• CLI 또는 애플리케이션의 구성 설정에서 지정된 환경 변수를 사용합니다. CLI 플래그에서 환경 변수 이름을 파생하려면 접두사 MW_MCP_SERVER_을(를) 추가하고, 대문자로 변환하고, 하이픈(-)을 밑줄(_)로 바꿉니다. 예를 들어, 인수 --matlab-root은(는) 환경 변수 MW_MCP_SERVER_MATLAB_ROOT이(가) 됩니다. 둘 다 사용하는 경우 CLI 플래그가 환경 변수보다 우선합니다. | 인수 | 설명 | 예시 | | ------------- | ------------- | ------------- | | help | 모든 인수에 대한 도움말 정보를 표시합니다. | --help | | version | MATLAB MCP 서버의 버전을 표시합니다. | --version | | matlab-root | 시작할 MATLAB을 지정하는 전체 경로입니다. 경로에 /bin를 포함하지 마십시오. 기본적으로 서버는 시스템 PATH에서 첫 번째 MATLAB을 찾으려고 시도합니다. | Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a
  
  Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a
  
  환경 변수로: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a | | initialize-matlab-on-startup | 서버 시작 시 MATLAB을 초기화하려면 이 인수를 true로 설정하십시오. 기본적으로 MATLAB은 첫 번째 도구가 호출될 때만 시작됩니다. | --initialize-matlab-on-startup=true | | initial-working-folder | MATLAB이 시작되는 폴더를 지정합니다. 값을 지정하지 않으면 MATLAB은 AI 애플리케이션의 첫 번째 루트 (MCP) 경로에서 시작됩니다. 루트를 정의하지 않은 경우 MATLAB은 다음 위치에서 시작됩니다:
  
  • Linux: /home/username
  • Windows: C:\Users\username\Documents
  • Mac: /Users/username/Documents
  | Windows: --initial-working-folder=C:\\Users\\username\\MyProject
  
  Linux/macOS: --initial-working-folder=/Users/username/MyProject | | matlab-display-mode | MATLAB 데스크톱을 표시할지 여부를 지정합니다. MATLAB 데스크톱을 표시하려면 desktop 모드(기본값)를 사용하십시오. MATLAB 데스크톱 없이 AI 애플리케이션에서만 MATLAB을 사용하려면 nodesktop 모드를 사용하십시오. nodesktop 모드에서는 그래픽 인터페이스가 필요한 명령(예: edit, open, open_system, uifigure, appdesigner)이 여전히 데스크톱에 MATLAB 창을 엽니다. | --matlab-display-mode=nodesktop | | matlab-session-mode | MCP 서버가 새 MATLAB을 시작할지 또는 기존 MATLAB 세션에 연결할지 지정합니다(MATLAB R2023a 이상 지원). 기본값은 auto 모드입니다.
  
  new 모드: MCP 서버가 새 MATLAB 세션을 시작합니다.
  
  auto 모드 (기본값): 서버가 기존 MATLAB 세션에 연결을 시도하며, 이 세션은 아래 지침을 사용하여 existing 모드로 구성되어 있어야 합니다. 서버가 기존 MATLAB 세션을 찾을 수 없으면 새 세션을 시작합니다.
  
  existing 모드: 서버가 기존 MATLAB 세션에 연결을 시도합니다. 이 모드를 사용하려면 다음 단계에 따라 MATLAB 세션을 미리 구성해야 합니다:
  
  
  1. 처음으로 existing 모드를 사용하는 경우 ./matlab-mcp-server --setup-matlab을 실행하십시오.
     
     이 명령은 MATLAB에 MATLAB MCP Server Toolbox라는 애드온을 설치합니다. 이 표의 다른 인수를 사용하여 명령을 사용자 지정할 수 있습니다. 예를 들어, 툴박스를 설치할 MATLAB을 지정하려면 ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a를 사용할 수 있습니다.
     
     Claude Desktop의 경우 ./matlab-mcp-server --setup-matlab을 실행하기 전에 설정의 지침에 따라 MATLAB MCP 서버 바이너리를 다운로드해야 합니다.
     
     
  2. 실행 중인 MATLAB 세션의 명령 창에서 shareMATLABSession()을 실행합니다. --matlab-session-mode=existing 또는 --matlab-session-mode=auto으로 서버를 시작하면 MCP 서버가 이 MATLAB에 연결됩니다. 여러 MATLAB 세션을 실행 중인 경우 서버는 shareMATLABSession() 명령을 가장 최근에 실행한 MATLAB 세션에 연결됩니다.
     
     수동으로 shareMATLABSession()을 실행하는 대신 MATLAB 시작 스크립트 (MathWorks)에 명령을 추가할 수 있습니다.
  | --matlab-session-mode=existing | | extension-file | 사용자 지정 MCP 도구를 사용하려면 도구를 정의하는 JSON 파일의 경로를 제공하십시오. 여러 확장 파일을 사용할 수도 있습니다. 사용자 지정 도구 사용에 대한 자세한 내용은 MATLAB MCP 서버에서 사용자 지정 도구 사용을 참조하십시오. |
  
  Windows: --extension-file=C:\\Users\\name\\my-tools.json
  
  Linux/macOS: --extension-file=/path/to/my-tools.json
  
  여러 확장 파일 사용:
  
  Windows:--extension-file=C:\\path\\to\\tools-1.json --extension-file=C:\\path\\to\\tools-2.json
  
  Linux/macOS:--extension-file=/path/to/tools1.json --extension-file=/path/to/tools2.json
  
  환경 변수 사용:
  
  Windows: MW_MCP_SERVER_EXTENSION_FILE=C:\Users\name\tools1.json;C:\Users\name\tools2.json
  
  Linux/macOS: MW_MCP_SERVER_EXTENSION_FILE=/path/to/tools1.json:/path/to/tools2.json | | log-folder | MCP 서버가 로그 파일을 저장할 폴더를 지정합니다. 지정하지 않으면 서버는 운영 체제의 기본 임시 폴더를 사용합니다. | Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp
  
  Linux/macOS: --log-folder=/tmp/my-logs | | log-level | MCP 서버의 로그 수준입니다. 유효한 값은 자세한 정도가 높은 순서대로 debug, info, warn, error입니다. | --log-level=debug | | disable-telemetry | 익명화된 데이터 수집을 비활성화하려면 이 인수를 true로 설정하십시오. 자세한 내용은 데이터 수집을 참조하십시오. | --disable-telemetry=true |

도구

1. detect_matlab_toolboxes

   • 버전 번호를 포함하여 설치된 MATLAB 및 툴박스에 대한 정보를 반환합니다.

2. check_matlab_code

   • MATLAB 스크립트에 대한 정적 코드 분석을 수행합니다. 코딩 스타일, 잠재적 오류, 사용되지 않는 함수, 성능 문제 및 모범 사례 위반에 대한 경고를 반환합니다. 이는 스크립트를 실행하지 않고 코드 품질 문제를 식별하는 데 도움이 되는 비파괴적 읽기 전용 작업입니다.
   • 입력:
     • script_path (문자열): 분석할 MATLAB 스크립트 파일의 절대 경로입니다. 유효한 .m 파일이어야 합니다. 분석 중에 파일은 수정되지 않습니다. 예: C:\Users\username\matlab\myFunction.m 또는 /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • MATLAB 코드 문자열을 평가하고 출력을 반환합니다.
   • 입력:
     • code (문자열): 평가할 MATLAB 코드입니다.
     • project_path (문자열): 프로젝트 디렉터리의 절대 경로입니다. MATLAB은 이 디렉터리를 현재 작업 폴더로 설정합니다. 예: C:\Users\username\matlab-project 또는 /home/user/research.

4. run_matlab_file

   • MATLAB 스크립트를 실행하고 출력을 반환합니다. 스크립트는 유효한 .m file이어야 합니다.
   • 입력:
     • script_path (문자열): 실행할 MATLAB 스크립트 파일의 절대 경로입니다. 유효한 .m 파일이어야 합니다. 예: C:\Users\username\projects\analysis.m 또는 /home/user/matlab/simulation.m.

5. run_matlab_test_file

   • MATLAB 테스트 스크립트를 실행하고 포괄적인 테스트 결과를 반환합니다. MATLAB 테스트 프레임워크 규칙을 따르는 MATLAB 단위 테스트 파일용으로 특별히 설계되었습니다.
   • 입력:
     • script_path (문자열): MATLAB 테스트 스크립트 파일의 절대 경로입니다. MATLAB 단위 테스트가 포함된 유효한 .m 파일이어야 합니다. 예: C:\Users\username\tests\testMyFunction.m 또는 /home/user/matlab/tests/test_analysis.m.

리소스

MCP 서버는 AI 애플리케이션이 MATLAB 코드를 작성하는 데 도움이 되는 리소스 (MCP)를 제공합니다. 이 리소스 사용에 대한 지침을 보려면 리소스 사용 방법을 설명하는 AI 애플리케이션의 문서를 참조하십시오.

1. matlab_coding_guidelines

   • 코드 가독성, 유지 관리성 및 협업을 향상시키기 위한 포괄적인 MATLAB 코딩 표준을 제공합니다. 지침에는 명명 규칙, 서식 지정, 주석 달기, 성능 최적화 및 오류 처리가 포함됩니다.
   • URI: guidelines://coding
   • MIME 유형: text/markdown
   • 출처: MATLAB 코딩 표준 (GitHub)

2. plain_text_live_code_guidelines

   • 버전 관리 및 AI 지원 개발에 적합한 일반 텍스트 Live Code .m 파일 형식을 사용하여 라이브 스크립트를 생성하기 위한 규칙과 지침을 제공합니다. 일반 텍스트 라이브 스크립트를 실행하려면 MATLAB R2025a 이상이 필요합니다. 자세한 내용은 Live Code 파일 형식 (MathWorks)을 참조하십시오.
   • URI: guidelines://plain-text-live-code
   • MIME 유형: text/markdown
   • 출처: 일반 텍스트 Live Code 생성 (GitHub)

데이터 수집

MATLAB MCP 서버는 서버 사용에 대한 완전히 익명화된 정보를 수집하여 MathWorks에 보낼 수 있습니다. 이 데이터 수집은 제품 개선에 도움이 되며 기본적으로 활성화되어 있습니다. 데이터 수집을 거부하려면 --disable-telemetry 인수를 true로 설정하십시오.

보안 고려 사항

MATLAB MCP 서버를 사용할 때는 모든 도구 호출을 실행하기 전에 철저히 검토하고 검증해야 합니다. 중요한 작업에는 항상 사람이 개입하도록 하고 호출이 예상한 대로 정확히 수행될 것이라고 확신할 때만 진행하십시오. 자세한 내용은 사용자 상호 작용 모델 (MCP) 및 보안 고려 사항 (MCP)을 참조하십시오.

라이선스 및 사용

라이선스는 이 GitHub 리포지토리의 LICENSE.md 파일에서 확인할 수 있습니다.

MCP 서버는 MathWorks 소프트웨어 라이선스 계약에 따라 MATLAB과 함께 사용하는 것만 허용되며, 여러 사용자가 공유해서는 안 됩니다. 공유 또는 중앙 집중식 서버 사용을 지원해야 하는 경우 MathWorks에 문의하십시오.

지원 문의

MathWorks는 이 리포지토리를 사용하고 피드백을 제공하도록 권장합니다. 기술 지원을 요청하거나 개선 요청을 제출하려면 GitHub 이슈를 생성하거나 MathWorks 기술 지원에 문의하십시오.

---

Copyright 2025-2026 The MathWorks, Inc.

---