MATLAB MCP — Casos de uso, Instalar & Demo ao vivo

Name: MATLAB MCP Server
Author: matlab

Por que usar

Principais recursos

Oficial — mantido pela MathWorks
Execução de código (evaluate_matlab_code), execução de arquivo (run_matlab_file), análise estática (check_matlab_code)
Executor de testes unitários retorna resultados estruturados
Detecção de ferramentas — o agente sabe quais ferramentas estão disponíveis antes de gerar código

Demo ao vivo

Como fica na prática

matlab.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": [
        "matlab-mcp-core-server"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": [
        "matlab-mcp-core-server"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": [
        "matlab-mcp-core-server"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "matlab": {
      "command": "uvx",
      "args": [
        "matlab-mcp-core-server"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "matlab",
      "command": "uvx",
      "args": [
        "matlab-mcp-core-server"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "matlab": {
      "command": {
        "path": "uvx",
        "args": [
          "matlab-mcp-core-server"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add matlab -- uvx matlab-mcp-core-server

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: MATLAB

Gerar, analisar e executar um script MATLAB

👤 Pesquisadores de engenharia, engenheiros de controle/DSP ⏱ ~20 min intermediate

Quando usar: Você quer prototipar um cálculo em MATLAB conversacionalmente — gerar, executar, ajustar, repetir.

Pré-requisitos

MATLAB R2020b+ instalado e no PATH — O comando matlab -help de um terminal deve funcionar
MATLAB registrado como Servidor de Automação Pessoal — Execute matlab.engine.shareEngine em MATLAB uma vez — veja README do MCP

Fluxo

Verificar capacidades

Detecte ferramentas MATLAB instaladas. Preciso de Processamento de Sinais e Sistema de Controle.✓ Copiado

→ Lista com versões; o agente sabe o que pode usar
Gerar o script

Escreva um script MATLAB que carrega signal.mat, aplica um filtro passa-baixa Butterworth a 50Hz, plota antes/depois. Salve como ./lp_filter.m.✓ Copiado

→ Arquivo .m escrito
Verificar depois executar

Execute check_matlab_code em lp_filter.m. Corrija qualquer problema. Depois execute run_matlab_file e retorne o caminho do gráfico.✓ Copiado

→ Verificações estáticas passam, script executa, figura de saída salva

Resultado: Protótipos MATLAB funcionais em minutos sem trocar de janelas.

Armadilhas

Caminhos relativos falham — MATLAB inicia em seu próprio diretório de trabalho — Sempre use caminhos absolutos em script_path e dentro do script; ou execute cd para seu diretório como primeira linha
Script trava em janelas uiopen/plot em modo não interativo — Use figure('Visible','off') e saveas() para arquivo em vez de exibir

Combine com: filesystem

Executar testes unitários MATLAB e iterar sobre falhas

👤 Engenheiros mantendo bases de código MATLAB ⏱ ~20 min intermediate

Quando usar: Você tem uma suíte de testes (matlab.unittest) e quer que o agente a execute e ajude a corrigir regressões.

Pré-requisitos

Arquivo de teste usando matlab.unittest — Classes herdando de matlab.unittest.TestCase

Fluxo

Executar a suíte

Execute testes em ./tests/MyAlgorithmTest.m. Retorne resultado aprovado/reprovado por método mais qualquer texto de erro.✓ Copiado

→ Relatório de teste estruturado
Diagnosticar

Para cada falha, leia a assertiva, leia a implementação, explique a lacuna.✓ Copiado

→ Causa raiz por falha
Corrigir e executar novamente

Aplique correções mínimas à implementação (não testes). Execute novamente até ficar verde.✓ Copiado

→ Todos os testes passam

Resultado: Loop TDD sobre código MATLAB conduzido pelo agente.

Armadilhas

Testes dependem de arquivos não no caminho MATLAB — Adicione addpath(genpath(pwd)) no início do teste, ou passe project_path explicitamente

Combinações

Combine com outros MCPs para 10× de alavancagem

matlab + filesystem

Ler arquivos de dados → executar cálculo MATLAB → salvar arquivos de resultado

Leia ./data/*.csv, escreva um script MATLAB que processe cada um, salve saídas em ./processed/. Execute e confirme.✓ Copiado

matlab + git

Controlar versão dos scripts gerados pelo agente

Gere o script de análise MATLAB, execute-o, verifique se os resultados parecem bons, depois faça commit do script com uma mensagem descritiva.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
detect_matlab_toolboxes		Primeiro passo — saiba o que você pode usar	free
check_matlab_code	script_path (absolute)	Lint antes de executar — captura problemas óbvios rapidamente	free
evaluate_matlab_code	code: str, project_path (absolute)	Expressão única ou código inline	free
run_matlab_file	script_path (absolute)	Execute um arquivo .m salvo	free
run_matlab_test_file	script_path (absolute)	Execução de testes estruturada	free

Custo e limites

O que custa rodar

Cota de API: Nenhum — execução local MATLAB
Tokens por chamada: Saídas de script podem ser grandes (gráficos, tabelas). Limite dados retornados.
Monetário: Licença MATLAB necessária (não é gratuita); o MCP em si é gratuito
Dica: Peça ao agente para escrever gráficos em arquivos em vez de retornar grandes matrizes numéricas em respostas

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum — execução local

Saída de dados: Nenhum — MATLAB é executado localmente

Solução de problemas

Erros comuns e correções

'Motor MATLAB não encontrado' na primeira chamada

Registre MATLAB como Servidor de Automação Pessoal: em MATLAB execute matlab.engine.shareEngine. Reinicie o MCP depois.

Verificar: From terminal: `python -c 'import matlab.engine; matlab.engine.find_matlab()'` — should list engines

Scripts com erro 'Função indefinida'

A função está em uma ferramenta que não está instalada, ou não está no caminho MATLAB. Execute detect_matlab_toolboxes e confirme.

check_matlab_code não relata nada mas falha em tempo de execução

mlint captura sintaxe não semântica. Use evaluate_matlab_code com uma pequena entrada de teste para validar lógica.

Script de execução longa expira tempo

Clientes MCP têm tempos limite por chamada. Divida o script em etapas, salvando resultados intermediários em disco; execute etapa por etapa.

Alternativas

MATLAB vs. outros

Alternativa	Quando usar	Troca
Octave via shell MCP	Você não tem uma licença MATLAB e precisa de código aberto	Compatível sintaticamente no núcleo, mas ferramentas frequentemente diferem significativamente
Python (numpy/scipy) via a Python-exec MCP	Você está disposto a traduzir o fluxo de trabalho	Gratuito, ecossistema enorme, mas você desiste de ferramentas específicas do MATLAB (Simulink, etc.)

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills