MATLAB MCP 서버

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

설정 요구 사항

Python 3.11(Python 3.13 및 3.12는 현재 MATLAB Engine에서 지원되지 않습니다)
MATLAB R2024a(또는 호환 버전)
uv 패키지 관리자

Related MCP server: Fused MCP Agents

설치

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

지엑스피1

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

디렉토리 구조

matlab_server.py : 주요 MCP 서버 구현
matlab_scripts/ : 모든 MATLAB 스크립트와 함수가 저장되는 디렉토리(자동으로 생성됨)
pyproject.toml : Python 프로젝트 구성
.python-version : uv의 Python 버전을 지정합니다.

Claude 데스크톱 통합

Claude Desktop 구성을 엽니다.

# On macOS code ~/Library/Application\ Support/Claude/claude_desktop_config.json

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

{ "mcpServers": { "matlab": { "command": "uv", "args": [ "--directory", "/absolute/path/to/matlab-mcp", "run", "matlab_server.py" ], "env": { "MATLAB_PATH": "/Applications/MATLAB_R2024a.app" } } } }

다음 사항을 확인하세요.

/absolute/path/to/matlab-mcp 프로젝트 디렉토리의 실제 경로로 바꾸세요.
MATLAB_PATH 가 MATLAB 설치를 가리키는지 확인하세요.
절대 경로를 사용하세요(상대 경로가 아님)

특징

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

create_matlab_script : 새로운 MATLAB 스크립트 파일을 생성합니다.
- 스크립트는 matlab_scripts 디렉토리에 저장됩니다.
- 파일 이름은 유효한 MATLAB 식별자여야 합니다.
create_matlab_function : 새로운 MATLAB 함수 파일을 생성합니다.
- 함수는 matlab_scripts 디렉토리에 저장됩니다.
- 유효한 함수 정의를 포함해야 합니다.
execute_matlab_script : MATLAB 스크립트를 실행하고 결과를 얻습니다.
- 출력 텍스트, 생성된 그림 및 작업 공간 변수를 반환합니다.
- 스크립트에 인수를 전달할 수 있습니다
call_matlab_function : 인수를 사용하여 MATLAB 함수를 호출합니다.
- 함수 출력과 생성된 모든 수치를 반환합니다.

테스트

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

# Make sure you're in your virtual environment source .venv/bin/activate # Run the inspector MATLAB_PATH=/Applications/MATLAB_R2024a.app mcp dev matlab_server.py

테스트 스크립트 예시:

t = 0:0.01:2*pi; y = sin(t); plot(t, y); title('Test Plot'); xlabel('Time'); ylabel('Amplitude');

스크립트 저장소

모든 MATLAB 스크립트와 함수는 matlab_scripts 디렉토리에 저장됩니다.
이 디렉토리는 서버가 시작될 때 자동으로 생성됩니다.
파일 이름은 <script_name>.m 또는 <function_name>.m 입니다.
디렉토리는 matlab_server.py 와 같은 위치에 있습니다.

환경 변수

MATLAB_PATH : MATLAB 설치 경로
- 기본값: /Applications/MATLAB_R2024a.app
- Claude Desktop 구성에서 설정하거나 직접 실행할 때

문제 해결

MATLAB 엔진 설치 실패
- MATLAB_PATH가 올바른지 확인하세요
- 엔진을 수동으로 설치해보세요:
  cd $MATLAB_PATH/extern/engines/python python setup.py install
Python 버전 문제
- Python 3.11을 사용하고 있는지 확인하세요.
- 확인 방법: python --version
- 필요한 경우 uv python pin 3.11 사용하세요
스크립트 실행 오류
- matlab_scripts 디렉토리가 있는지 확인하세요
- 스크립트 구문이 유효한지 확인하세요
- MATLAB 출력에서 오류 메시지를 찾으세요