local-only server

The server can only run on the client’s local machine because it depends on local resources.

MATLAB MCP 서버

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

설정 요구 사항

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

설치

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 출력에서 오류 메시지를 찾으세요

업데이트 및 유지 관리

MATLAB 설치를 최신 상태로 유지하세요
필요에 따라 Python 패키지를 업데이트합니다: uv pip install --upgrade mcp[cli]
Python을 업데이트할 때 MATLAB 엔진 호환성을 확인하세요

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude 또는 다른 MCP 클라이언트를 통해 스크립트와 함수를 만들고 실행하여 MATLAB와 상호 작용하고, 환경 구성 기능을 통해 스크립트 관리 및 실행 결과 검색을 지원합니다.

Related Resources

Reddit Discussion about this server

MATLAB MCP Server