MATLAB MCP Core Server

oficial

Ejecute MATLAB® usando aplicaciones de IA con el servidor oficial MATLAB MCP Server de MathWorks®.

GitHub

1.7k

¿Qué puedes hacer con MATLAB Core MCP?

Ejecutar código de MATLAB — Pídele a tu IA que evalúe fragmentos de código de MATLAB y devuelva la salida mediante evaluate_matlab_code.
Ejecutar scripts y pruebas — Haz que tu IA ejecute archivos .m o .p, incluidas pruebas unitarias, y obtenga resultados mediante run_matlab_file o run_matlab_test_file.
Verificar la calidad del código — Solicita un análisis estático de un script de MATLAB para estilo, errores y mejores prácticas usando check_matlab_code.
Inspeccionar el entorno de MATLAB — Pídele a tu IA que liste las toolbox de MATLAB instaladas y los detalles de versión con detect_matlab_toolboxes.

Documentación

Servidor MCP de MATLAB

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

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

Inicien y cierren MATLAB.
Escriban y ejecuten código de MATLAB.
Evalúen su código de MATLAB en cuanto a estilo y corrección.

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

Configuración

Instale MATLAB (MathWorks) R2021a o posterior y agréguelo a la ruta del sistema (PATH).
El servidor admite cualquier aplicación de IA que utilice el Protocolo de Contexto de Modelos (MCP). Para configurar el servidor MCP de MATLAB para Claude Desktop, salte 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 que pueda ejecutar el servidor MCP de MATLAB:
```
chmod +x ~/Downloads/matlab-mcp-server
```
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 ejemplos de instrucciones 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 obtuvo 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 obtener 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

Instala el servidor MCP de MATLAB en Claude Desktop utilizando el paquete del servidor MCP de MATLAB.

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 que el servidor MCP acceda, luego alterne el botón Deshabilitado a Habilitar para la extensión Filesystem.
Descargue el paquete del servidor MCP de MATLAB matlab-mcp-server.mcpb desde la página de Última Versión.
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 obtuvo 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 obtener 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 obtuvo 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

[!NOTA] Usuarios de Windows: Codex no reenvía la variable de entorno WINDIR, que necesita para ejecutar MATLAB y Simulink (ver #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 las siguientes maneras:

Inserte los argumentos en la configuración de su aplicación de IA (generalmente un archivo .json).
Ingrese los argumentos como banderas de interfaz de línea de comandos (CLI) al iniciar el servidor.
Use variables de entorno, especificadas ya sea en su CLI o en la configuración de la aplicación. Para derivar el nombre de la variable de entorno 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 servidor MCP de MATLAB.	`--version`
matlab-root	Ruta completa que especifica qué MATLAB iniciar. No incluya `/bin` en la ruta. Por defecto, el servidor intenta encontrar el primer MATLAB en la ruta del sistema (PATH).	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`. Por defecto, MATLAB solo se inicia cuando se llama a la primera herramienta.	`--initialize-matlab-on-startup=true`
initial-working-folder	Especifique la carpeta donde MATLAB se inicia. 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 mostrar el escritorio de MATLAB. Use el modo `desktop` (predeterminado) para mostrar el escritorio de MATLAB. Use 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`) aún abrirán 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 modo predeterminado es `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, que debe haber configurado para el modo `existing` usando 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. No use este modo junto con los argumentos `matlab-root`, `initial-working-folder` o `matlab-display-mode`. Debe haber configurado su sesión de MATLAB de antemano para usar este modo, con estos pasos: Si está usando 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 la caja de herramientas, puede usar `./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a`. Para Claude Desktop, debe descargar el binario del servidor MCP de MATLAB usando las instrucciones en Configuración antes de ejecutar `./matlab-mcp-server --setup-matlab`. 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 múltiples 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 (MathWorks) de MATLAB.	`--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 múltiples archivos de extensión. Para detalles sobre el uso de herramientas personalizadas, consulte Usar Herramientas Personalizadas con el Servidor MCP de MATLAB.	Windows: `--extension-file=C:\\Users\\name\\my-tools.json` Linux/macOS: `--extension-file=/path/to/my-tools.json` Usando múltiples 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` Usando 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 archivos de registro. Si no se especifica, el servidor usa 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`. El valor predeterminado es `info`.	`--log-level=debug`
disable-telemetry	Para deshabilitar la recopilación de datos anónimos, establezca este argumento en `true`. Para detalles, consulte Recopilación de Datos.	`--disable-telemetry=true`

Herramientas

detect_matlab_toolboxes
- Devuelve información sobre MATLAB instalado y cajas de herramientas, incluidos los números de versión.
check_matlab_code
- Realiza un análisis estático de código en un script de MATLAB. Devuelve advertencias sobre estilo de codificación, errores potenciales, funciones obsoletas, problemas de rendimiento y violaciones de 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 que se va 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.
evaluate_matlab_code
- Evalúa una cadena de código de MATLAB y devuelve la salida.
- Entradas:
  - code (cadena): Código de 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.
run_matlab_file
- Ejecuta un script de MATLAB y devuelve la salida. El script debe ser un archivo fuente de MATLAB válido (.m) o un archivo P-code (.p). Si un archivo fuente de MATLAB (.m) y un archivo P-code (.p) tienen el mismo nombre y están en la misma carpeta, MATLAB ejecuta el archivo .p.
- Entradas:
  - script_path (cadena): Ruta absoluta al archivo de script de MATLAB que se va a ejecutar. Debe ser un archivo fuente de MATLAB válido (.m) o un archivo P-code (.p). Ejemplo: C:\Users\username\projects\analysis.m o /home/user/matlab/simulation.m.
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 fuente de MATLAB válido (.m) o un archivo P-code (.p) 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 de 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.

matlab_coding_guidelines
- Proporciona estándares integrales de codificación de MATLAB 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 de MATLAB (GitHub)
plain_text_live_code_guidelines
- Proporciona reglas y pautas para generar scripts en vivo utilizando el formato de archivo .m de Live Code en texto plano, adecuado para el control de versiones y el desarrollo asistido por IA. Tenga en cuenta que para ejecutar scripts en vivo en texto plano necesita MATLAB R2025a o más reciente. Para más detalles, consulte Formato de Archivo de 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 servidor MCP de MATLAB puede recopilar información totalmente 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 por defecto. Para optar por no participar en la recopilación de datos, establezca el argumento --disable-telemetry en true.

Consideraciones de Seguridad

Al usar el servidor MCP de MATLAB, debe revisar y validar minuciosamente todas las llamadas a herramientas antes de ejecutarlas. Mantenga siempre a una persona en el circuito para acciones importantes y solo continúe una vez que esté seguro de que la llamada hará exactamente lo que espera. Para más información, consulte Modelo de Interacción con el Usuario (MCP) y Consideraciones de Seguridad (MCP).

Licencia y Uso

La licencia está disponible en el archivo LICENSE.md en 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 compartirse entre múltiples usuarios. Comuníquese con MathWorks si necesita soporte para uso compartido o centralizado del servidor.

Contacto de Soporte

MathWorks lo alienta a usar este repositorio y proporcionar comentarios. Para solicitar soporte técnico o enviar una solicitud de mejora, cree un problema de GitHub o contacte al Soporte Técnico de MathWorks.