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
- 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 MCPmatlab_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