Integración de MATLAB MCP

Esta es una implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para MATLAB. Permite a los clientes MCP (como los agentes LLM o Claude Desktop) interactuar con una sesión compartida de MATLAB mediante la API de MATLAB Engine para Python.

Características

• Ejecutar código MATLAB: ejecute fragmentos de código MATLAB arbitrarios mediante la herramienta runMatlabCode .

• Recuperar variables: obtenga el valor de las variables del espacio de trabajo de MATLAB utilizando la herramienta getVariable .

• Comunicación estructurada: las herramientas devuelven resultados y errores como JSON estructurado para facilitar su uso programático por parte de los clientes.

• Ejecución sin bloqueo: las llamadas al motor MATLAB se ejecutan de forma asincrónica mediante asyncio.to_thread para evitar el bloqueo del servidor.

• Registro estándar: utiliza el módulo logging estándar de Python y envía la salida a stderr para mayor visibilidad en los registros del cliente.

• Sesión compartida: se conecta a una sesión MATLAB compartida existente.

HACER:

• Agregue una herramienta setVariable para escribir datos en el espacio de trabajo de MATLAB.

• Agregue una herramienta runScript para ejecutar archivos .m directamente.

• Agregue herramientas para la gestión del espacio de trabajo (por ejemplo, clearWorkspace , getWorkspaceVariables ).

• Amplíe el asistente matlab_to_python para manejar tipos de datos más complejos (estructuras, matrices de celdas, objetos).

• Agregue soporte para interactuar con modelos de Simulink.

Requisitos

• Python 3.12 o superior

• MATLAB ( se recomienda R2023a o superior ; verifique la API de MATLAB Engine para compatibilidad con Python) con la API de MATLAB Engine para Python instalada.

• Paquete Python numpy .

Instalación

1. Clonar este repositorio:

   git clone https://github.com/jigarbhoye04/MatlabMCP.git cd MatlabMCP

2. Configurar un entorno virtual de Python (recomendado):

   # Install uv if you haven't already: https://github.com/astral-sh/uv uv init uv venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate

3. Instalar dependencias:

   uv pip sync

4. Asegúrese de que MATLAB esté instalado y que la API de MATLAB Engine para Python esté configurada para su entorno Python. Consulte la documentación de MATLAB .

5. Inicie MATLAB y comparta su motor: Ejecute el siguiente comando en la ventana de comandos de MATLAB:

   matlab.engine.shareEngine

   Puede verificar que se comparte ejecutando matlab.engine.isEngineShared en MATLAB (debería devolver true o 1 "). El servidor MCP necesita este motor compartido para conectarse.

Configuración (para Claude Desktop)

Para utilizar este servidor con Claude Desktop:

1. Vaya a Claude Desktop -> Configuración -> Desarrollador -> Editar configuración.

2. Esto abrirá claude_desktop_config.json . Agregue o modifique la sección mcpServers para incluir la configuración MatlabMCP :

   { "mcpServers": { "MatlabMCP": { "command": "C:\\Users\\username\\.local\\bin\\uv.exe", // Path to your uv executable "args": [ "--directory", "C:\\Users\\username\\Desktop\\MatlabMCP\\", // ABSOLUTE path to the cloned repository directory "run", "main.py" ] // Optional: Add environment variables if needed // "env": { // "MY_VAR": "value" // } } // Add other MCP servers here if you have them } }

3. IMPORTANTE: Reemplace las rutas C:\\Users\\username\\... con las rutas absolutas correctas para su sistema.

4. Guarde el archivo y reinicie Claude Desktop .

5. Registro: los registros del servidor (del módulo logging de Python) aparecerán en los archivos de registro MCP de Claude Desktop (accesibles a través de tail -f ~/Library/Logs/Claude/mcp-server-MatlabMCP.log en macOS o consultando %APPDATA%\Claude\logs\ en Windows).

Desarrollo

Estructura del proyecto:

Documentación

Consulte Actualizaciones para obtener documentación detallada sobre las características del servidor, el uso y las notas de desarrollo.

Contribuyendo

¡Agradecemos sus contribuciones! Si tiene alguna sugerencia o mejora, no dude en abrir un problema o enviar una solicitud de incorporación de cambios.

¡Hagamos esto aún mejor juntos!