MATLAB MCP Server

local-only server

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

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

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]"
  1. 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
  1. 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
-
security - not tested
F
license - not found
-
quality - not tested

Permite la interacción con MATLAB mediante la creación y ejecución de scripts y funciones a través de Claude u otros clientes MCP, soportando la gestión de scripts y la recuperación de resultados de ejecución con capacidades de configuración del entorno.

  1. Setup Requirements
    1. Installation
      1. Directory Structure
        1. Claude Desktop Integration
          1. Features
            1. Testing
              1. Script Storage
                1. Environment Variables
                  1. Troubleshooting
                    1. Updates and Maintenance
                      ID: tf2154y420