Servidor MATLAB MCP

Este servidor de Protocolo de Contexto de Modelo (MCP) proporciona integración con MATLAB, lo que le permite crear y ejecutar scripts y funciones de MATLAB a través de Claude u otros clientes MCP.

Requisitos de configuración

Python 3.11 (Python 3.13 y 3.12 no son compatibles actualmente con MATLAB Engine)
MATLAB R2024a (o versión compatible)
administrador de paquetes uv

Related MCP server: Fused MCP Agents

Instalación

Cree y configure el entorno de Python:

# Pin Python version uv python pin 3.11 # Create virtual environment uv venv # Activate virtual environment source .venv/bin/activate # Install MCP uv add "mcp[cli]"

Instalar MATLAB Engine MATLAB Engine se instalará automáticamente cuando el servidor se ejecute por primera vez, utilizando la instalación de MATLAB especificada en la variable de entorno MATLAB_PATH .

Estructura del directorio

matlab_server.py : La implementación principal del servidor MCP
matlab_scripts/ : Directorio donde se guardan todos los scripts y funciones de MATLAB (se crean automáticamente)
pyproject.toml : configuración del proyecto Python
.python-version : especifica la versión de Python para uv

Integración de escritorio de Claude

Abra la configuración de Claude Desktop:

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

Agregue la configuración del servidor MATLAB:

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

Asegúrese de:

Reemplace /absolute/path/to/matlab-mcp con la ruta real al directorio de su proyecto
Verifique que MATLAB_PATH apunte a su instalación de MATLAB
Utilice rutas absolutas (no relativas)

Características

El servidor proporciona varias herramientas:

create_matlab_script : Crea un nuevo archivo de script de MATLAB
- Los scripts se guardan en el directorio matlab_scripts
- Los nombres de archivo deben ser identificadores válidos de MATLAB
create_matlab_function : Crea un nuevo archivo de función MATLAB
- Las funciones se guardan en el directorio matlab_scripts
- Debe incluir una definición de función válida
execute_matlab_script : ejecuta un script de MATLAB y obtiene resultados
- Devuelve texto de salida, figuras generadas y variables del espacio de trabajo
- Puede pasar argumentos a scripts
call_matlab_function : Llamar a una función de MATLAB con argumentos
- Devuelve la salida de la función y cualquier cifra generada

Pruebas

Puede probar el servidor utilizando el Inspector MCP:

# 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

Ejemplo de script de prueba:

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

Almacenamiento de scripts

Todos los scripts y funciones de MATLAB se guardan en el directorio matlab_scripts
Este directorio se crea automáticamente cuando se inicia el servidor.
Los archivos se llaman <script_name>.m o <function_name>.m
El directorio está en la misma ubicación que matlab_server.py

Variables de entorno

MATLAB_PATH : Ruta a su instalación de MATLAB
- Predeterminado: /Applications/MATLAB_R2024a.app
- Configurar en la configuración de Claude Desktop o al ejecutarlo directamente

Solución de problemas

La instalación del motor MATLAB falla
- Verifique que MATLAB_PATH sea correcto
- Intente instalar el motor manualmente:
  cd $MATLAB_PATH/extern/engines/python python setup.py install
Problemas con la versión de Python
- Asegúrate de estar usando Python 3.11
- Consulte con: python --version
- Utilice uv python pin 3.11 si es necesario
Errores de ejecución de scripts
- Compruebe que el directorio matlab_scripts existe
- Verificar que la sintaxis del script sea válida
- Busque mensajes de error en la salida de MATLAB

Actualizaciones y mantenimiento

Mantenga su instalación de MATLAB actualizada
Actualice los paquetes de Python según sea necesario: uv pip install --upgrade mcp[cli]
Comprobar la compatibilidad del motor MATLAB al actualizar Python