MATLAB MCP Core Server

oficial

Execute MATLAB® usando aplicações de IA com o servidor oficial MATLAB MCP Server da MathWorks®.

GitHub

1.7k

O que você pode fazer com MATLAB Core MCP?

Executar código MATLAB — Peça à sua IA para avaliar trechos de código MATLAB e retornar a saída via evaluate_matlab_code.
Executar scripts e testes — Faça sua IA rodar arquivos .m ou .p, incluindo testes unitários, e obter os resultados via run_matlab_file ou run_matlab_test_file.
Verificar qualidade do código — Solicite análise estática de um script MATLAB para estilo, erros e boas práticas usando check_matlab_code.
Inspecionar ambiente MATLAB — Peça à sua IA para listar toolboxes instalados do MATLAB e detalhes de versão com detect_matlab_toolboxes.

Documentação

Servidor MCP do MATLAB

Inglês • Espanhol • Japonês • Coreano • Chinês (Simplificado)

Execute o MATLAB® usando aplicativos de IA com o Servidor MCP oficial do MATLAB da MathWorks®. O Servidor MCP do MATLAB permite que seus aplicativos de IA:

Iniciem e encerrem o MATLAB.
Escrevam e executem código MATLAB.
Avaliem seu código MATLAB quanto a estilo e correção.

Para ajudar seu agente a usar o MATLAB e o Simulink, você pode usar as habilidades do MATLAB Agentic Toolkit (GitHub) e do Simulink Agentic Toolkit (GitHub), que também podem instalar este servidor MCP para você.

Configuração

Instale o MATLAB (MathWorks) R2021a ou posterior e adicione-o ao PATH do sistema.
O servidor suporta qualquer aplicativo de IA que use o Model Context Protocol. Para configurar o Servidor MCP do MATLAB para o Claude Desktop, vá diretamente para as instruções do Claude Desktop. Para configurar o servidor para outros aplicativos, siga estas instruções:
- Para Windows ou Linux, Baixe a Versão Mais Recente. (Alternativamente, você pode compilar a partir do código-fonte: instale o Go e compile o binário usando go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).
- Para macOS, primeiro baixe a versão mais recente executando o seguinte comando no seu terminal:
  - Para processadores Apple silicon, execute:
```
curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64
```
  - Para processadores Intel, execute:
```
curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64
```
  Em seguida, conceda permissões de execução ao binário baixado para que você possa executar o Servidor MCP do MATLAB:
```
chmod +x ~/Downloads/matlab-mcp-server
```
Adicione o Servidor MCP do MATLAB ao seu aplicativo de IA. Você pode encontrar instruções para adicionar servidores MCP na documentação do seu aplicativo de IA. Para exemplos de instruções sobre o uso do Claude Code®, Claude Desktop® e GitHub Copilot no Visual Studio® Code, veja abaixo. Observe que você pode personalizar o servidor especificando Argumentos opcionais.

Claude Code

No seu terminal, execute o seguinte, lembrando de inserir o caminho completo para o binário do servidor que você obteve na configuração:

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

Você pode personalizar o servidor especificando Argumentos opcionais. Observe o separador -- entre as opções do Claude Code e os argumentos do servidor:

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

Para obter detalhes sobre como adicionar servidores MCP no Claude Code, consulte Adicionar um servidor stdio local (Claude Code). Para remover o servidor posteriormente, execute:

claude mcp remove matlab

Claude Desktop

Você instala o Servidor MCP do MATLAB no Claude Desktop usando o pacote do Servidor MCP do MATLAB.

Instale a extensão Filesystem no Claude Desktop para permitir que o Claude leia e escreva arquivos no seu sistema. No Claude Desktop, clique em Configurações > Extensões > Procurar extensões. Pesquise pela extensão Filesystem desenvolvida pela Anthropic e clique em Instalar. Especifique as pastas às quais você deseja permitir que o servidor MCP acesse e, em seguida, alterne o botão Desativado para Ativar a extensão Filesystem.
Baixe o pacote do Servidor MCP do MATLAB matlab-mcp-server.mcpb na página da Versão Mais Recente.
Para instalar o pacote do Servidor MCP do MATLAB como uma extensão de desktop, clique duas vezes no arquivo matlab-mcp-server.mcpb baixado e clique em Instalar no Claude Desktop. (Alternativamente, navegue no Claude para Menu Arquivo > Configurações > Extensões > Configurações Avançadas > Instalar Extensão e selecione o arquivo matlab-mcp-server.mcpb. Clique em Instalar).

Para personalizar o comportamento do Servidor MCP do MATLAB, navegue até Configurações > Extensões > Configurar, onde você pode modificar os Argumentos do servidor.

GitHub Copilot no Visual Studio Code

No seu espaço de trabalho do VS Code, crie um arquivo chamado .vscode/mcp.json. Insira o seguinte JSON, lembrando de especificar o caminho completo para o binário do servidor que você obteve na configuração, bem como quaisquer Argumentos. Em seguida, salve o arquivo. (Observe que no Windows, seus caminhos exigem barras extras como caracteres de escape).

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

Para obter mais informações sobre o uso de servidores MCP no VS Code, consulte Adicionar e gerenciar servidores MCP no VS Code (VS Code).

Codex

No seu terminal, execute o seguinte, lembrando de inserir o caminho completo para o binário do servidor que você obteve na configuração:

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

Você pode personalizar o servidor especificando Argumentos opcionais. Por exemplo:

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

[!NOTA] Usuários do Windows: O Codex não encaminha a variável de ambiente WINDIR, que você precisa para executar o MATLAB e o Simulink (veja #32).

Para adicionar a variável, abra seu arquivo de configuração do Codex em C:\Users\<username>\.codex\config.toml e adicione env_vars = ["WINDIR"] à seção [mcp_servers.matlab]:
[mcp_servers.matlab]
command = 'C:\caminho\completo\para\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

Argumentos

Personalize o comportamento do servidor especificando argumentos de uma das seguintes maneiras:

Insira os argumentos nas configurações do seu aplicativo de IA (geralmente um arquivo .json).
Insira os argumentos como sinalizadores de interface de linha de comando (CLI) ao iniciar o servidor.
Use variáveis de ambiente, especificadas na sua CLI ou nas configurações do aplicativo. Para derivar o nome da variável de ambiente de um sinalizador de CLI, adicione o prefixo MW_MCP_SERVER_, converta para maiúsculas e substitua hífens (-) por sublinhados (_). Por exemplo, o argumento --matlab-root torna-se a variável de ambiente MW_MCP_SERVER_MATLAB_ROOT. Os sinalizadores de CLI têm precedência sobre as variáveis de ambiente, se você usar ambos.

Argumento	Descrição	Exemplo
help	Exibe informações de ajuda para todos os argumentos.	`--help`
version	Exibe a versão do Servidor MCP do MATLAB.	`--version`
matlab-root	Caminho completo especificando qual MATLAB iniciar. Não inclua `/bin` no caminho. Por padrão, o servidor tenta encontrar o primeiro MATLAB no PATH do sistema.	Windows: `--matlab-root=C:\\Program Files\\MATLAB\\R2026a` Linux/macOS: `--matlab-root=/home/usr/MATLAB/R2026a` Como variável de ambiente: `MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a`
initialize-matlab-on-startup	Para inicializar o MATLAB assim que você iniciar o servidor, defina este argumento como `true`. Por padrão, o MATLAB só inicia quando a primeira ferramenta é chamada.	`--initialize-matlab-on-startup=true`
initial-working-folder	Especifique a pasta onde o MATLAB inicia. Se você não especificar um valor, o MATLAB inicia no caminho do primeiro Root (MCP) do seu aplicativo de IA. Se você não definiu um root, o MATLAB inicia nestes locais: 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 se deseja mostrar a área de trabalho do MATLAB. Use o modo `desktop` (padrão) para mostrar a área de trabalho do MATLAB. Use o modo `nodesktop` para usar o MATLAB apenas pelo seu aplicativo de IA, sem a área de trabalho do MATLAB. Observe que no modo `nodesktop`, comandos que exigem uma interface gráfica (como `edit`, `open`, `open_system`, `uifigure` e `appdesigner`) ainda abrirão janelas do MATLAB na sua área de trabalho.	`--matlab-display-mode=nodesktop`
matlab-session-mode	Especifique se o servidor MCP inicia um novo MATLAB ou conecta-se a uma sessão MATLAB existente (suportado para MATLAB R2023a em diante). O padrão é o modo `auto`. Modo `new`: O servidor MCP inicia uma nova sessão MATLAB. Modo `auto` (padrão): O servidor tenta conectar-se a uma sessão MATLAB existente, que você deve ter configurado para o modo `existing` usando as instruções abaixo. Se o servidor não conseguir encontrar uma sessão MATLAB existente, ele inicia uma nova. Modo `existing`: O servidor tenta conectar-se a uma sessão MATLAB existente. Não use este modo em conjunto com os argumentos `matlab-root`, `initial-working-folder` ou `matlab-display-mode`. Você deve ter configurado sua sessão MATLAB antecipadamente para usar este modo, com estes passos: Se você estiver usando o modo `existing` pela primeira vez, execute `./matlab-mcp-server --setup-matlab`. Este comando instala um complemento chamado MATLAB MCP Server Toolbox no MATLAB. Você pode personalizar o comando com outros argumentos desta tabela. Por exemplo, para especificar qual MATLAB usar para instalar a toolbox, você pode usar `./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a`. Para o Claude Desktop, você deve baixar o binário do Servidor MCP do MATLAB usando as instruções em Configuração antes de executar `./matlab-mcp-server --setup-matlab`. Na janela de comando de uma sessão MATLAB em execução, execute `shareMATLABSession()`. O servidor MCP conectará a este MATLAB quando você iniciar o servidor com `--matlab-session-mode=existing` ou `--matlab-session-mode=auto`. Se você estiver executando várias sessões MATLAB, o servidor conecta-se à sessão MATLAB onde você executou mais recentemente o comando `shareMATLABSession()`. Como alternativa a executar `shareMATLABSession()` manualmente, você pode adicionar o comando ao seu Script de Inicialização (MathWorks) do MATLAB.	`--matlab-session-mode=existing`
extension-file	Para usar ferramentas MCP personalizadas, forneça um caminho para um arquivo JSON que define suas ferramentas. Você também pode usar vários arquivos de extensão. Para detalhes sobre o uso de ferramentas personalizadas, consulte Usar Ferramentas Personalizadas com o Servidor MCP do MATLAB.	Windows: `--extension-file=C:\\Users\\name\\my-tools.json` Linux/macOS: `--extension-file=/path/to/my-tools.json` Usando vários arquivos de extensão: 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 variáveis de ambiente: 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 a pasta onde o servidor MCP armazena arquivos de log. Se não for especificado, o servidor usa a pasta temporária padrão do seu sistema operacional.	Windows: `--log-folder=C:\\Users\\name\\AppData\\Local\\Temp` Linux/macOS: `--log-folder=/tmp/my-logs`
log-level	Os níveis de log do servidor MCP. Valores válidos, em ordem decrescente de verbosidade, são `debug`, `info`, `warn` e `error`. O padrão é `info`.	`--log-level=debug`
disable-telemetry	Para desativar a coleta de dados anonimizados, defina este argumento como `true`. Para detalhes, consulte Coleta de Dados.	`--disable-telemetry=true`

Ferramentas

detect_matlab_toolboxes
- Retorna informações sobre o MATLAB instalado e toolboxes, incluindo números de versão.
check_matlab_code
- Realiza análise estática de código em um script MATLAB. Retorna avisos sobre estilo de codificação, erros potenciais, funções obsoletas, problemas de desempenho e violações de boas práticas. Esta é uma operação não destrutiva e somente leitura que ajuda a identificar problemas de qualidade de código sem executar o script.
- Entradas:
  - script_path (string): Caminho absoluto para o arquivo de script MATLAB a ser analisado. Deve ser um arquivo .m válido. O arquivo não é modificado durante a análise. Exemplo: C:\Users\username\matlab\myFunction.m ou /home/user/scripts/analysis.m.
evaluate_matlab_code
- Avalia uma string de código MATLAB e retorna a saída.
- Entradas:
  - code (string): Código MATLAB a ser avaliado.
  - project_path (string): Caminho absoluto para o diretório do seu projeto. O MATLAB define este diretório como a pasta de trabalho atual. Exemplo: C:\Users\username\matlab-project ou /home/user/research.
run_matlab_file
- Executa um script MATLAB e retorna a saída. O script deve ser um arquivo de código-fonte MATLAB válido (.m) ou um arquivo P-code (.p). Se um arquivo de código-fonte MATLAB (.m) e um arquivo P-code (.p) tiverem o mesmo nome e estiverem na mesma pasta, o MATLAB executa o arquivo .p.
- Entradas:
  - script_path (string): Caminho absoluto para o arquivo de script MATLAB a ser executado. Deve ser um arquivo de código-fonte MATLAB válido (.m) ou um arquivo P-code (.p). Exemplo: C:\Users\username\projects\analysis.m ou /home/user/matlab/simulation.m.
run_matlab_test_file
- Executa um script de teste MATLAB e retorna resultados abrangentes do teste. Projetado especificamente para arquivos de teste de unidade MATLAB que seguem as convenções do framework de testes MATLAB.
- Entradas:
  - script_path (string): Caminho absoluto para o arquivo de script de teste MATLAB. Deve ser um arquivo de código-fonte MATLAB válido (.m) ou um arquivo P-code (.p) contendo testes de unidade MATLAB. Exemplo: C:\Users\username\tests\testMyFunction.m ou /home/user/matlab/tests/test_analysis.m.

Recursos

O servidor MCP fornece Recursos (MCP) para ajudar seu aplicativo de IA a escrever código MATLAB. Para ver instruções sobre como usar este recurso, consulte a documentação do seu aplicativo de IA que explica como usar recursos.

matlab_coding_guidelines
- Fornece padrões abrangentes de codificação MATLAB para melhorar a legibilidade, manutenibilidade e colaboração do código. As diretrizes abrangem convenções de nomenclatura, formatação, comentários, otimização de desempenho e tratamento de erros.
- URI: guidelines://coding
- Tipo MIME: text/markdown
- Fonte: Padrões de Codificação MATLAB (GitHub)
plain_text_live_code_guidelines
- Fornece regras e diretrizes para gerar scripts ao vivo usando o formato de arquivo Live Code .m em texto simples, adequado para controle de versão e desenvolvimento assistido por IA. Observe que para executar scripts ao vivo em texto simples, você precisa do MATLAB R2025a ou mais recente. Para detalhes, consulte Formato de Arquivo Live Code (MathWorks).
- URI: guidelines://plain-text-live-code
- Tipo MIME: text/markdown
- Fonte: Geração de Live Code em Texto Simples (GitHub)

Coleta de Dados

O MATLAB MCP Server pode coletar informações totalmente anonimizadas sobre seu uso do servidor e enviá-las à MathWorks. Esta coleta de dados ajuda a MathWorks a melhorar produtos e está ativada por padrão. Para desativar a coleta de dados, defina o argumento --disable-telemetry como true.

Considerações de Segurança

Ao usar o MATLAB MCP Server, você deve revisar e validar minuciosamente todas as chamadas de ferramentas antes de executá-las. Sempre mantenha um humano no processo para ações importantes e prossiga somente quando estiver confiante de que a chamada fará exatamente o que você espera. Para mais informações, consulte Modelo de Interação com o Usuário (MCP) e Considerações de Segurança (MCP).

Licenciamento e Uso

A licença está disponível no arquivo LICENSE.md neste repositório GitHub.

Os servidores MCP só podem ser usados com MATLAB de acordo com o Contrato de Licença de Software da MathWorks e não devem ser compartilhados por vários usuários. Entre em contato com a MathWorks se precisar de suporte para uso compartilhado ou centralizado do servidor.

Contato de Suporte

A MathWorks incentiva você a usar este repositório e fornecer feedback. Para solicitar suporte técnico ou enviar uma solicitação de melhoria, crie uma issue no GitHub ou entre em contato com o Suporte Técnico da MathWorks.