MATLAB

Servidor MCP de MATLAB

Este servidor del Protocolo de Contexto de Modelos (MCP) proporciona integración con MATLAB, permitiéndote 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)
• Gestor de paquetes uv

Instalación

1. Crea y configura 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. Instala MATLAB Engine MATLAB Engine se instalará automáticamente la primera vez que se ejecute el servidor, utilizando la instalación de MATLAB especificada en la variable de entorno MATLAB_PATH.

Estructura de Directorios

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

Integración con Claude Desktop

1. Abre la configuración de tu Claude Desktop:

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

2. Añade 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úrate de:

• Reemplazar /absolute/path/to/matlab-mcp con la ruta real a tu directorio del proyecto
• Verificar que MATLAB_PATH apunte a tu instalación de MATLAB
• Usar rutas absolutas (no relativas)

Características

El servidor proporciona varias herramientas:

1. create_matlab_script: Crear 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: Crear un nuevo archivo de función de MATLAB

   • Las funciones se guardan en el directorio matlab_scripts
   • Deben incluir una definición de función válida

3. execute_matlab_script: Ejecutar un script de MATLAB y obtener resultados

   • Devuelve texto de salida, figuras generadas y variables del espacio de trabajo
   • Puede pasar argumentos a los scripts

4. call_matlab_function: Llamar a una función de MATLAB con argumentos

   • Devuelve la salida de la función y cualquier figura generada

Pruebas

Puedes probar el servidor usando 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 el servidor se inicia
• Los archivos se nombran <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 tu instalación de MATLAB
  • Valor predeterminado: /Applications/MATLAB_R2024a.app
  • Se configura en la configuración de Claude Desktop o al ejecutarlo directamente

Solución de Problemas

1. Falla la Instalación de MATLAB Engine

   • Verifica que MATLAB_PATH sea correcto
   • Intenta instalar el engine manualmente:

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

2. Problemas con la Versión de Python

   • Asegúrate de usar Python 3.11
   • Verifica con: python --version
   • Usa uv python pin 3.11 si es necesario

3. Errores de Ejecución de Scripts

   • Comprueba que el directorio matlab_scripts exista
   • Verifica que la sintaxis del script sea válida
   • Busca mensajes de error en la salida de MATLAB

Actualizaciones y Mantenimiento

• Mantén tu instalación de MATLAB actualizada
• Actualiza los paquetes de Python según sea necesario: uv pip install --upgrade mcp[cli]
• Verifica la compatibilidad del engine de MATLAB al actualizar Python