MATLAB MCP Core Server

Servidor MCP de MATLAB

English • Español • 日本語 • 한국어 • 简体中文

[!WARNING] A partir de la versión v0.11.0, MATLAB MCP Core Server ha sido renombrado a MATLAB MCP Server. Para usar la última versión del servidor después de este cambio, debe actualizar su configuración.

Cambios	Acción requerida
Nombres de binarios Nuevo formato: matlab-mcp-server-<os>-<arch>[.exe] Ejemplo: matlab-mcp-server-windows-x64.exe	Actualice el nombre del binario en los ajustes de configuración de su aplicación de IA, normalmente un archivo .json.
Toolbox Actualizado y renombrado: MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox	Instale la última versión del toolbox ejecutando ./matlab-mcp-server --setup-matlab. Necesita el toolbox para conectarse a sesiones de MATLAB existentes. Para más detalles, consulte matlab-session-mode en la sección Argumentos.
URL del repositorio github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Ninguna. GitHub redirige automáticamente.
Paquete MCP Actualizado y renombrado: matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb	Si usó el paquete MCP de MATLAB para instalar el servidor MCP en Claude Desktop antes de la v0.11.0, primero desinstale el servidor, luego descargue el nuevo paquete matlab-mcp-server.mcpb desde la página Última versión y úselo para reinstalar el servidor. Para más detalles, consulte la sección sobre Claude Desktop.
Módulo Go github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Si está usando el módulo MATLAB MCP Core Server en un proyecto Go, actualice el nombre del módulo en go.mod y sus declaraciones de importación.

Ejecute MATLAB® usando aplicaciones de IA con el servidor MCP oficial de MATLAB de MathWorks®. El servidor MCP de MATLAB permite a sus aplicaciones de IA:

• Iniciar y cerrar MATLAB.
• Escribir y ejecutar código MATLAB.
• Evaluar su código MATLAB en cuanto a estilo y corrección.

Para ayudar a su agente a usar MATLAB y Simulink, puede usar habilidades de MATLAB Agentic Toolkit (GitHub) y Simulink Agentic Toolkit (GitHub), que también pueden instalar este servidor MCP por usted.

Tabla de contenidos

• Configuración
  • Claude Code
  • Claude Desktop
  • GitHub Copilot en Visual Studio Code
  • Codex
• Argumentos
• Herramientas
• Recursos
• Recopilación de datos
• Consideraciones de seguridad
• Licencias y uso
• Contactar con soporte

Configuración

1. Instale MATLAB (MathWorks) R2021a o posterior y agréguelo al PATH del sistema. El servidor MCP de MATLAB es compatible con versiones de MATLAB de los últimos cinco años.

2. El servidor es compatible con cualquier aplicación de IA que use el Protocolo de Contexto de Modelo. Para configurar el servidor MCP de MATLAB para Claude Desktop, vaya directamente a las instrucciones para Claude Desktop. Para configurar el servidor para otras aplicaciones, siga estas instrucciones:

   • Para Windows o Linux, Descargue la última versión. (Alternativamente, puede compilar desde el código fuente: instale Go y compile el binario usando go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).

   • Para macOS, primero descargue la última versión ejecutando el siguiente comando en su terminal:

     • Para procesadores Apple silicon, ejecute:

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
       

     • Para procesadores Intel, ejecute:

       curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
       

     Luego otorgue permisos de ejecución al binario descargado para poder ejecutar el servidor MCP de MATLAB:

     chmod +x ~/Downloads/matlab-mcp-server
     

3. Agregue el servidor MCP de MATLAB a su aplicación de IA. Puede encontrar instrucciones para agregar servidores MCP en la documentación de su aplicación de IA. Para ver instrucciones de ejemplo sobre el uso de Claude Code®, Claude Desktop® y GitHub Copilot en Visual Studio® Code, consulte a continuación. Tenga en cuenta que puede personalizar el servidor especificando Argumentos opcionales.

Claude Code

En su terminal, ejecute lo siguiente, recordando insertar la ruta completa al binario del servidor que adquirió en la configuración:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary

Puede personalizar el servidor especificando Argumentos opcionales. Tenga en cuenta el separador -- entre las opciones de Claude Code y los argumentos del servidor:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

Para más detalles sobre cómo agregar servidores MCP en Claude Code, consulte Agregar un servidor stdio local (Claude Code). Para eliminar el servidor más tarde, ejecute:

claude mcp remove matlab

Claude Desktop

Instale el servidor MCP de MATLAB en Claude Desktop usando el paquete del servidor MCP de MATLAB.

1. Instale la extensión Filesystem en Claude Desktop para permitir que Claude lea y escriba archivos en su sistema. En Claude Desktop, haga clic en Configuración > Extensiones > Explorar extensiones. Busque la extensión Filesystem desarrollada por Anthropic y haga clic en Instalar. Especifique las carpetas a las que desea permitir el acceso al servidor MCP, luego cambie el botón Deshabilitado a Habilitar la extensión Filesystem.

2. Descargue el paquete del servidor MCP de MATLAB matlab-mcp-server.mcpb desde la página Última versión.

3. Para instalar el paquete del servidor MCP de MATLAB como una extensión de escritorio, haga doble clic en el archivo matlab-mcp-server.mcpb descargado y haga clic en Instalar en Claude Desktop. (Alternativamente, navegue en Claude a Menú Archivo > Configuración > Extensiones > Configuración avanzada > Instalar extensión y seleccione el archivo matlab-mcp-server.mcpb. Haga clic en Instalar).

Para personalizar el comportamiento del servidor MCP de MATLAB, navegue a Configuración > Extensiones > Configurar, donde puede modificar los Argumentos del servidor.

GitHub Copilot en Visual Studio Code

En su espacio de trabajo de VS Code, cree un archivo llamado .vscode/mcp.json. Inserte el siguiente JSON, recordando especificar la ruta completa al binario del servidor que adquirió en la configuración, así como cualquier Argumento. Luego guarde el archivo. (Tenga en cuenta que en Windows, sus rutas requieren barras adicionales como caracteres de escape).

{
    "servers": {
        "matlab": {
            "type": "stdio",
            "command": "C:\\fullpath\\to\\matlab-mcp-server-windows-x64.exe",
            "args": []
        }
    }
}

Para más información sobre el uso de servidores MCP en VS Code, consulte Agregar y administrar servidores MCP en VS Code (VS Code).

Codex

En su terminal, ejecute lo siguiente, recordando insertar la ruta completa al binario del servidor que adquirió en la configuración:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary

Puede personalizar el servidor especificando Argumentos opcionales. Por ejemplo:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

[!NOTE] Usuarios de Windows: Codex no reenvía la variable de entorno WINDIR, que necesita para ejecutar MATLAB y Simulink (consulte #32).

Para agregar la variable, abra su archivo de configuración de Codex en C:\Users\<username>\.codex\config.toml y agregue env_vars = ["WINDIR"] a la sección [mcp_servers.matlab]:

[mcp_servers.matlab]
command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

Argumentos

Personalice el comportamiento del servidor especificando argumentos de una de estas maneras:

• Inserte los argumentos en los ajustes de configuración de su aplicación de IA (normalmente un archivo .json).
• Ingrese los argumentos como banderas de interfaz de línea de comandos (CLI) cuando inicie el servidor.
• Use variables de entorno, especificadas ya sea en su CLI o en los ajustes de configuración de la aplicación. Para derivar el nombre de la variable de entorno a partir de una bandera CLI, agregue el prefijo MW_MCP_SERVER_, convierta a mayúsculas y reemplace los guiones (-) con guiones bajos (_). Por ejemplo, el argumento --matlab-root se convierte en la variable de entorno MW_MCP_SERVER_MATLAB_ROOT. Las banderas CLI tienen prioridad sobre las variables de entorno, si usa ambas. | Argumento | Descripción | Ejemplo | | ------------- | ------------- | ------------- | | help | Muestra información de ayuda para todos los argumentos. | --help | | version | Muestra la versión del MATLAB MCP Server. | --version | | matlab-root | Ruta completa que especifica qué MATLAB iniciar. No incluya /bin en la ruta. De forma predeterminada, el servidor intenta encontrar el primer MATLAB en el PATH del sistema. | Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a
  
  Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a
  
  Como variable de entorno: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a | | initialize-matlab-on-startup | Para inicializar MATLAB tan pronto como inicie el servidor, establezca este argumento en true. De forma predeterminada, MATLAB solo se inicia cuando se llama a la primera herramienta. | --initialize-matlab-on-startup=true | | initial-working-folder | Especifique la carpeta donde se inicia MATLAB. Si no especifica un valor, MATLAB se inicia en la ruta de la primera Raíz (MCP) de su aplicación de IA. Si no ha definido una raíz, MATLAB se inicia en estas ubicaciones:
  
  • Linux: /home/username
  • Windows: C:\Users\username\Documents
  • Mac: /Users/username/Documents
  | Windows: --initial-working-folder=C:\\Users\\username\\MyProject
  
  Linux/macOS: --initial-working-folder=/Users/username/MyProject | | matlab-display-mode | Especifique si se muestra el escritorio de MATLAB. Utilice el modo desktop (predeterminado) para mostrar el escritorio de MATLAB. Utilice el modo nodesktop para usar MATLAB solo desde su aplicación de IA, sin el escritorio de MATLAB. Tenga en cuenta que en el modo nodesktop, los comandos que requieren una interfaz gráfica (como edit, open, open_system, uifigure y appdesigner) seguirán abriendo ventanas de MATLAB en su escritorio. | --matlab-display-mode=nodesktop | | matlab-session-mode | Especifique si el servidor MCP inicia un nuevo MATLAB o se conecta a una sesión de MATLAB existente (compatible con MATLAB R2023a en adelante). El valor predeterminado es el modo auto.
  
  Modo new: El servidor MCP inicia una nueva sesión de MATLAB.
  
  Modo auto (predeterminado): El servidor intenta conectarse a una sesión de MATLAB existente, la cual debe haber configurado para el modo existing siguiendo las instrucciones a continuación. Si el servidor no puede encontrar una sesión de MATLAB existente, inicia una nueva.
  
  Modo existing: El servidor intenta conectarse a una sesión de MATLAB existente. Debe haber configurado su sesión de MATLAB de antemano para usar este modo, con estos pasos:
  
  
  1. Si está utilizando el modo existing por primera vez, ejecute ./matlab-mcp-server --setup-matlab.
     
     Este comando instala un complemento llamado MATLAB MCP Server Toolbox en MATLAB. Puede personalizar el comando con otros argumentos de esta tabla. Por ejemplo, para especificar qué MATLAB usar para instalar el toolbox, puede usar ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a.
     
     Para Claude Desktop, debe descargar el binario del MATLAB MCP Server siguiendo las instrucciones en Configuración antes de ejecutar ./matlab-mcp-server --setup-matlab.
     
     
  2. En la ventana de comandos de una sesión de MATLAB en ejecución, ejecute shareMATLABSession(). El servidor MCP se conectará a este MATLAB cuando inicie el servidor con --matlab-session-mode=existing o --matlab-session-mode=auto. Si está ejecutando varias sesiones de MATLAB, el servidor se conecta a la sesión de MATLAB donde ejecutó más recientemente el comando shareMATLABSession().
     
     Como alternativa a ejecutar shareMATLABSession() manualmente, puede agregar el comando a su Script de inicio de MATLAB (MathWorks).
  | --matlab-session-mode=existing | | extension-file | Para usar herramientas MCP personalizadas, proporcione una ruta a un archivo JSON que defina sus herramientas. También puede usar varios archivos de extensión. Para obtener más información sobre el uso de herramientas personalizadas, consulte Usar herramientas personalizadas con el MATLAB MCP Server. |
  
  Windows: --extension-file=C:\\Users\\name\\my-tools.json
  
  Linux/macOS: --extension-file=/path/to/my-tools.json
  
  Uso de varios archivos de extensión:
  
  Windows:--extension-file=C:\\path\\to\\tools-1.json --extension-file=C:\\path\\to\\tools-2.json
  
  Linux/macOS:--extension-file=/path/to/tools1.json --extension-file=/path/to/tools2.json
  
  Uso de variables de entorno:
  
  Windows: MW_MCP_SERVER_EXTENSION_FILE=C:\Users\name\tools1.json;C:\Users\name\tools2.json
  
  Linux/macOS: MW_MCP_SERVER_EXTENSION_FILE=/path/to/tools1.json:/path/to/tools2.json | | log-folder | Especifique la carpeta donde el servidor MCP almacena los archivos de registro. Si no se especifica, el servidor utiliza la carpeta temporal predeterminada de su sistema operativo. | Windows: --log-folder=C:\\Users\\name\\AppData\\Local\\Temp
  
  Linux/macOS: --log-folder=/tmp/my-logs | | log-level | Los niveles de registro del servidor MCP. Los valores válidos, en orden de verbosidad decreciente, son debug, info, warn y error. | --log-level=debug | | disable-telemetry | Para deshabilitar la recopilación de datos anonimizados, establezca este argumento en true. Para obtener más información, consulte Recopilación de datos. | --disable-telemetry=true |

Herramientas

1. detect_matlab_toolboxes

   • Devuelve información sobre MATLAB y los toolboxes instalados, incluyendo los números de versión.

2. check_matlab_code

   • Realiza un análisis de código estático en un script de MATLAB. Devuelve advertencias sobre el estilo de codificación, posibles errores, funciones obsoletas, problemas de rendimiento y violaciones de las mejores prácticas. Esta es una operación no destructiva y de solo lectura que ayuda a identificar problemas de calidad del código sin ejecutar el script.
   • Entradas:
     • script_path (cadena): Ruta absoluta al archivo de script de MATLAB a analizar. Debe ser un archivo .m válido. El archivo no se modifica durante el análisis. Ejemplo: C:\Users\username\matlab\myFunction.m o /home/user/scripts/analysis.m.

3. evaluate_matlab_code

   • Evalúa una cadena de código MATLAB y devuelve la salida.
   • Entradas:
     • code (cadena): Código MATLAB a evaluar.
     • project_path (cadena): Ruta absoluta al directorio de su proyecto. MATLAB establece este directorio como la carpeta de trabajo actual. Ejemplo: C:\Users\username\matlab-project o /home/user/research.

4. run_matlab_file

   • Ejecuta un script de MATLAB y devuelve la salida. El script debe ser un .m file válido.
   • Entradas:
     • script_path (cadena): Ruta absoluta al archivo de script de MATLAB a ejecutar. Debe ser un archivo .m válido. Ejemplo: C:\Users\username\projects\analysis.m o /home/user/matlab/simulation.m.

5. run_matlab_test_file

   • Ejecuta un script de prueba de MATLAB y devuelve resultados de prueba completos. Diseñado específicamente para archivos de prueba unitaria de MATLAB que siguen las convenciones del marco de pruebas de MATLAB.
   • Entradas:
     • script_path (cadena): Ruta absoluta al archivo de script de prueba de MATLAB. Debe ser un archivo .m válido que contenga pruebas unitarias de MATLAB. Ejemplo: C:\Users\username\tests\testMyFunction.m o /home/user/matlab/tests/test_analysis.m.

Recursos

El servidor MCP proporciona Recursos (MCP) para ayudar a su aplicación de IA a escribir código MATLAB. Para ver instrucciones sobre cómo usar este recurso, consulte la documentación de su aplicación de IA que explica cómo usar los recursos.

1. matlab_coding_guidelines

   • Proporciona estándares de codificación MATLAB integrales para mejorar la legibilidad, el mantenimiento y la colaboración del código. Las pautas abarcan convenciones de nomenclatura, formato, comentarios, optimización del rendimiento y manejo de errores.
   • URI: guidelines://coding
   • Tipo MIME: text/markdown
   • Fuente: Estándares de codificación MATLAB (GitHub)

2. plain_text_live_code_guidelines

   • Proporciona reglas y pautas para generar live scripts utilizando el formato de archivo de texto plano Live Code .m, adecuado para el control de versiones y el desarrollo asistido por IA. Tenga en cuenta que para ejecutar live scripts de texto plano necesita MATLAB R2025a o más reciente. Para obtener más información, consulte Formato de archivo Live Code (MathWorks).
   • URI: guidelines://plain-text-live-code
   • Tipo MIME: text/markdown
   • Fuente: Generación de Live Code en texto plano (GitHub)

Recopilación de datos

El MATLAB MCP Server puede recopilar información completamente anonimizada sobre su uso del servidor y enviarla a MathWorks. Esta recopilación de datos ayuda a MathWorks a mejorar los productos y está activada de forma predeterminada. Para optar por no participar en la recopilación de datos, establezca el argumento --disable-telemetry en true.

Consideraciones de seguridad

Al usar el MATLAB MCP Server, debe revisar y validar minuciosamente todas las llamadas a herramientas antes de ejecutarlas. Mantenga siempre a una persona al tanto de las acciones importantes y solo proceda cuando esté seguro de que la llamada hará exactamente lo que espera. Para obtener más información, consulte Modelo de interacción del usuario (MCP) y Consideraciones de seguridad (MCP).

Licencias y uso

La licencia está disponible en el archivo LICENSE.md de este repositorio de GitHub.

Los servidores MCP solo pueden usarse con MATLAB de acuerdo con el Acuerdo de Licencia de Software de MathWorks, y no deben ser compartidos por múltiples usuarios. Póngase en contacto con MathWorks si necesita soporte para uso compartido o centralizado del servidor.

Contactar con soporte

MathWorks le anima a usar este repositorio y a proporcionar comentarios. Para solicitar soporte técnico o enviar una solicitud de mejora, cree un issue en GitHub o póngase en contacto con el Soporte técnico de MathWorks.

---

Copyright 2025-2026 The MathWorks, Inc.

---