MATLAB MCP Core Server

Servidor MATLAB MCP

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

[!WARNING] A partir da v0.11.0, o MATLAB MCP Core Server foi renomeado para MATLAB MCP Server. Para usar a versão mais recente do servidor após essa alteração, você deve atualizar suas configurações.

Alterações	Ação Necessária
Nomes dos binários Novo formato: matlab-mcp-server-<os>-<arch>[.exe] Exemplo: matlab-mcp-server-windows-x64.exe	Atualize o nome do binário nas configurações do seu aplicativo de IA, geralmente um arquivo .json.
Toolbox Atualizado e renomeado: MATLAB MCP Core Server Toolbox → MATLAB MCP Server Toolbox	Instale a versão mais recente do toolbox executando ./matlab-mcp-server --setup-matlab. Você precisa do toolbox para conectar-se a sessões existentes do MATLAB. Para detalhes, veja matlab-session-mode na seção Argumentos.
URL do repositório github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Nenhuma. O GitHub redireciona automaticamente.
Pacote MCP Atualizado e renomeado: matlab-mcp-core-server.mcpb → matlab-mcp-server.mcpb	Se você usou o pacote MATLAB MCP para instalar o servidor MCP no Claude Desktop antes da v0.11.0, primeiro desinstale o servidor, depois baixe o novo pacote matlab-mcp-server.mcpb da página Última Versão e use-o para reinstalar o servidor. Para detalhes, veja a seção sobre Claude Desktop.
Módulo Go github.com/matlab/matlab-mcp-core-server → github.com/matlab/matlab-mcp-server	Se você estiver usando o módulo MATLAB MCP Core Server em um projeto Go, atualize o nome do módulo em go.mod e suas declarações de importação.

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

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

Para auxiliar seu agente no uso do 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ê.

Índice

• 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
• Contatar Suporte

Configuração

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

2. O servidor oferece suporte a qualquer aplicativo de IA que use o Model Context Protocol. Para configurar o Servidor MATLAB MCP para o Claude Desktop, pule para as instruções do Claude Desktop. Para configurar o servidor para outros aplicativos, siga estas instruções:

   • Para Windows ou Linux, Baixe a Última Versão. (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 última versão 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 poder executar o Servidor MATLAB MCP:

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

3. Adicione o Servidor MATLAB MCP 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 como usar o 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-se de inserir o caminho completo para o binário do servidor que você adquiriu 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 detalhes sobre como adicionar servidores MCP no Claude Code, veja Adicionar um servidor stdio local (Claude Code). Para remover o servidor posteriormente, execute:

claude mcp remove matlab

Claude Desktop

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

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. Pesquise pela extensão Filesystem desenvolvida pela Anthropic e clique em Instalar. Especifique as pastas que deseja permitir que o servidor MCP acesse e, em seguida, alterne o botão Desabilitado para Habilitar a extensão Filesystem.

2. Baixe o pacote do Servidor MATLAB MCP matlab-mcp-server.mcpb da página Última Versão.

3. Para instalar o pacote do Servidor MATLAB MCP 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 Servidor MATLAB MCP, 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-se de especificar o caminho completo para o binário do servidor que você adquiriu 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 mais informações sobre o uso de servidores MCP no VS Code, veja Adicionar e Gerenciar servidores MCP no VS Code (VS Code).

Codex

No seu terminal, execute o seguinte, lembrando-se de inserir o caminho completo para o binário do servidor que você adquiriu 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 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:\fullpath\to\matlab-mcp-server-windows-x64.exe'
args = []
env_vars = ["WINDIR"]

Argumentos

Personalize o comportamento do servidor especificando argumentos de uma destas 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 a partir de um sinalizador 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 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) da sua aplicação de IA. Se você não tiver definido 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 exibir 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 a partir da sua aplicação de IA, sem a área de trabalho do MATLAB. Note 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 se conecta a uma sessão existente do MATLAB (compatível com MATLAB R2023a em diante). O padrão é o modo auto.
  
  Modo new: O servidor MCP inicia uma nova sessão do MATLAB.
  
  Modo auto (padrão): O servidor tenta se conectar a uma sessão existente do MATLAB, que você deve ter configurado para o modo existing usando as instruções abaixo. Se o servidor não conseguir encontrar uma sessão existente do MATLAB, ele inicia uma nova.
  
  Modo existing: O servidor tenta se conectar a uma sessão existente do MATLAB. Você deve ter configurado sua sessão do MATLAB previamente para usar este modo, com estas etapas:
  
  
  1. Se você estiver usando o modo existing pela primeira vez, execute ./matlab-mcp-server --setup-matlab.
     
     Este comando instala um add-on 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 o 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 Setup antes de executar ./matlab-mcp-server --setup-matlab.
     
     
  2. Na janela de comando de uma sessão do 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 do MATLAB, o servidor se conecta à sessão do MATLAB onde você executou o comando shareMATLABSession() mais recentemente.
     
     Como alternativa à execução manual de shareMATLABSession(), você pode adicionar o comando ao seu Startup Script (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 Use Custom Tools with the 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 os 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. Os valores válidos, em ordem decrescente de verbosidade, são debug, info, warn e error. | --log-level=debug | | disable-telemetry | Para desativar a coleta de dados anonimizados, defina este argumento como true. Para detalhes, consulte Data Collection. | --disable-telemetry=true |

Ferramentas

1. detect_matlab_toolboxes

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

2. check_matlab_code

   • Realiza análise de código estática 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 este 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 arquivo .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 de teste abrangentes. Projetado especificamente para arquivos de teste unitário MATLAB que seguem as convenções do framework de teste MATLAB.
   • Entradas:
     • script_path (string): Caminho absoluto para o arquivo de script de teste MATLAB. Deve ser um arquivo .m válido contendo testes unitários MATLAB. Exemplo: C:\Users\username\tests\testMyFunction.m ou /home/user/matlab/tests/test_analysis.m.

Recursos

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

1. matlab_coding_guidelines

   • Fornece padrões de codificação MATLAB abrangentes 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: MATLAB Coding Standards (GitHub)

2. plain_text_live_code_guidelines

   • Fornece regras e diretrizes para gerar live scripts usando o formato de arquivo Live Code .m em texto simples, adequado para controle de versão e desenvolvimento assistido por IA. Note que para executar live scripts em texto simples você precisa do MATLAB R2025a ou mais recente. Para detalhes, consulte Live Code File Format (MathWorks).
   • URI: guidelines://plain-text-live-code
   • Tipo MIME: text/markdown
   • Fonte: Plain Text Live Code Generation (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. Esta coleta de dados ajuda a MathWorks a melhorar os 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 circuito para ações importantes e prossiga apenas quando estiver confiante de que a chamada fará exatamente o que você espera. Para mais informações, consulte User Interaction Model (MCP) e Security Considerations (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 o 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 oferecer suporte ao uso compartilhado ou centralizado do servidor.

Contato com o 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.

---