MATLAB MCP Core Server

MATLAB MCP Server

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

Execute o MATLAB® usando aplicativos de IA com o MATLAB MCP Server oficial da MathWorks®. O MATLAB MCP Server 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 auxiliar seu agente no uso de MATLAB e Simulink, você pode usar habilidades do MATLAB Agentic Toolkit (GitHub) e do Simulink Agentic Toolkit (GitHub), que também podem instalar este servidor MCP para você.

Sumário

• Configuração
  • Claude Code
  • Claude Desktop
  • GitHub Copilot no Visual Studio Code
  • Codex
• Argumentos
• Ferramentas
• Recursos
• Coleta de Dados
• Considerações de Segurança
• Licenciamento e Uso
• Contato de Suporte

Configuração

1. Instale o MATLAB (MathWorks) R2021a ou posterior e adicione-o ao PATH do sistema. O MATLAB MCP Server suporta versões do MATLAB dos últimos cinco anos.

2. O servidor suporta qualquer aplicativo de IA que use o Model Context Protocol. Para configurar o MATLAB MCP Server 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 MATLAB MCP Server:

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

3. Adicione o MATLAB MCP Server ao seu aplicativo de IA. Você pode encontrar instruções para adicionar servidores MCP na documentação do seu aplicativo de IA. Por exemplo, instruções sobre o uso do Claude Code®, Claude Desktop® e GitHub Copilot no Visual Studio® Code estão 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 MATLAB MCP Server no Claude Desktop usando o pacote do MATLAB MCP Server.

1. Instale a extensão Filesystem no Claude Desktop para permitir que o Claude leia e grave arquivos no seu sistema. No Claude Desktop, clique em Configurações > Extensões > Procurar extensões. Procure pela extensão Filesystem desenvolvida pela Anthropic e clique em Instalar. Especifique as pastas que você deseja permitir que o servidor MCP acesse e, em seguida, alterne o botão Desativado para Ativar a extensão Filesystem.

2. Baixe o pacote do MATLAB MCP Server matlab-mcp-server.mcpb da página da Versão Mais Recente.

3. Para instalar o pacote do MATLAB MCP Server 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 até 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 MATLAB MCP Server, 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

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

Para adicionar a variável, abra o 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:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

Argumentos

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

• Insira os argumentos nas configurações do seu aplicativo de IA (geralmente um arquivo .json).
• Digite os argumentos como sinalizadores de interface de linha de comando (CLI) ao iniciar o servidor.
• Use variáveis de ambiente, especificadas no seu CLI ou nas configurações do aplicativo. Para derivar o nome da variável de ambiente a partir de um sinalizador de CLI, adicione o prefixo MW_MCP_SERVER_, converta para maiúsculas e substitua hifens (-) 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 MATLAB MCP Server.	--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 uma raiz, o MATLAB inicia nos seguintes 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 no seu aplicativo de IA, sem a área de trabalho do MATLAB. Observe que no modo nodesktop, comandos que exigem 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 se conecta a uma sessão MATLAB existente (suportado a partir do MATLAB R2023a). O padrão é o modo auto. Modo new: O servidor MCP inicia uma nova sessão MATLAB. Modo auto (padrão): O servidor tenta se conectar 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 se conectar a uma sessão MATLAB existente. Você deve configurar sua sessão MATLAB antecipadamente para usar este modo, com estas etapas: 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 MATLAB MCP Server 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 se 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 se conecta à 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).	--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 obter detalhes sobre o uso de ferramentas personalizadas, consulte Usar Ferramentas Personalizadas com o MATLAB MCP Server.	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 obter detalhes, consulte Coleta de Dados.	--disable-telemetry=true

Ferramentas

1. detect_matlab_toolboxes

   • Retorna informações sobre MATLAB e toolboxes instalados, incluindo números de versão.

2. 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.

3. 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 esse diretório como a pasta de trabalho atual. Exemplo: C:\Users\username\matlab-project ou /home/user/research.

4. run_matlab_file

   • Executa um script MATLAB e retorna a saída. O script deve ser um .m file válido.
   • Entradas:
     • script_path (string): Caminho absoluto para o arquivo de script MATLAB a ser executado. Deve ser um arquivo .m válido. Exemplo: C:\Users\username\projects\analysis.m ou /home/user/matlab/simulation.m.

5. 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 do MATLAB.
   • Entradas:
     • script_path (string): Caminho absoluto para o arquivo de script de teste MATLAB. Deve ser um arquivo .m válido 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 esse recurso, consulte a documentação do seu aplicativo de IA que explica como usar recursos.

1. matlab_coding_guidelines

   • Fornece padrões abrangentes de codificação MATLAB para melhorar a legibilidade, a manutenibilidade e a 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)

2. plain_text_live_code_guidelines

   • Fornece regras e diretrizes para gerar scripts ao vivo usando o formato de arquivo de código ao vivo em texto simples .m, 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 de Código ao Vivo (MathWorks).
   • URI: guidelines://plain-text-live-code
   • Tipo MIME: text/markdown
   • Fonte: Geração de Código ao Vivo em Texto Simples (GitHub)

Coleta de Dados

O MATLAB MCP Server pode coletar informações totalmente anonimizadas sobre o seu uso do servidor e enviá-las para a MathWorks. Essa coleta de dados ajuda a MathWorks a melhorar os produtos e está ativada por padrão. Para optar por não participar da 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 circuito para ações importantes e prossiga somente quando tiver certeza 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.

---

Copyright 2025-2026 The MathWorks, Inc.

---