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: MATLAB MCP Server

Instalación

1. 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]"

2. 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

1. Abra la configuración de Claude Desktop:

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

2. 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:

1. 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

2. 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

3. 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

4. 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

1. 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

2. 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

3. 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