MATLAB MCP 서버

이 모델 컨텍스트 프로토콜(MCP) 서버는 MATLAB와의 통합을 제공하여 Claude나 다른 MCP 클라이언트를 통해 MATLAB 스크립트와 함수를 만들고 실행할 수 있습니다.

설정 요구 사항

• Python 3.11(Python 3.13 및 3.12는 현재 MATLAB Engine에서 지원되지 않습니다)

• MATLAB R2024a(또는 호환 버전)

• uv 패키지 관리자

설치

1. Python 환경을 만들고 설정하세요.

지엑스피1

2. MATLAB 엔진 설치 MATLAB 엔진은 MATLAB_PATH 환경 변수에 지정된 MATLAB 설치를 사용하여 서버가 처음 실행될 때 자동으로 설치됩니다.

디렉토리 구조

• matlab_server.py : 주요 MCP 서버 구현

• matlab_scripts/ : 모든 MATLAB 스크립트와 함수가 저장되는 디렉토리(자동으로 생성됨)

• pyproject.toml : Python 프로젝트 구성

• .python-version : uv의 Python 버전을 지정합니다.

Claude 데스크톱 통합

1. Claude Desktop 구성을 엽니다.

2. MATLAB 서버 구성을 추가합니다.

다음 사항을 확인하세요.

• /absolute/path/to/matlab-mcp 프로젝트 디렉토리의 실제 경로로 바꾸세요.

• MATLAB_PATH 가 MATLAB 설치를 가리키는지 확인하세요.

• 절대 경로를 사용하세요(상대 경로가 아님)

특징

서버는 여러 가지 도구를 제공합니다.

1. create_matlab_script : 새로운 MATLAB 스크립트 파일을 생성합니다.

   • 스크립트는 matlab_scripts 디렉토리에 저장됩니다.

   • 파일 이름은 유효한 MATLAB 식별자여야 합니다.

2. create_matlab_function : 새로운 MATLAB 함수 파일을 생성합니다.

   • 함수는 matlab_scripts 디렉토리에 저장됩니다.

   • 유효한 함수 정의를 포함해야 합니다.

3. execute_matlab_script : MATLAB 스크립트를 실행하고 결과를 얻습니다.

   • 출력 텍스트, 생성된 그림 및 작업 공간 변수를 반환합니다.

   • 스크립트에 인수를 전달할 수 있습니다

4. call_matlab_function : 인수를 사용하여 MATLAB 함수를 호출합니다.

   • 함수 출력과 생성된 모든 수치를 반환합니다.

테스트

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

테스트 스크립트 예시:

스크립트 저장소

• 모든 MATLAB 스크립트와 함수는 matlab_scripts 디렉토리에 저장됩니다.

• 이 디렉토리는 서버가 시작될 때 자동으로 생성됩니다.

• 파일 이름은 <script_name>.m 또는 <function_name>.m 입니다.

• 디렉토리는 matlab_server.py 와 같은 위치에 있습니다.

환경 변수

• MATLAB_PATH : MATLAB 설치 경로

  • 기본값: /Applications/MATLAB_R2024a.app

  • Claude Desktop 구성에서 설정하거나 직접 실행할 때

문제 해결

1. MATLAB 엔진 설치 실패

   • MATLAB_PATH가 올바른지 확인하세요

   • 엔진을 수동으로 설치해보세요:

     cd $MATLAB_PATH/extern/engines/python python setup.py install

2. Python 버전 문제

   • Python 3.11을 사용하고 있는지 확인하세요.

   • 확인 방법: python --version

   • 필요한 경우 uv python pin 3.11 사용하세요

3. 스크립트 실행 오류

   • matlab_scripts 디렉토리가 있는지 확인하세요

   • 스크립트 구문이 유효한지 확인하세요

   • MATLAB 출력에서 오류 메시지를 찾으세요

업데이트 및 유지 관리

• MATLAB 설치를 최신 상태로 유지하세요

• 필요에 따라 Python 패키지를 업데이트합니다: uv pip install --upgrade mcp[cli]

• Python을 업데이트할 때 MATLAB 엔진 호환성을 확인하세요