MATLAB

Servidor MCP MATLAB

Este servidor do Model Context Protocol (MCP) fornece integração com o MATLAB, permitindo que você crie e execute scripts e funções MATLAB por meio do Claude ou de outros clientes MCP.

Requisitos de Configuração

• Python 3.11 (Python 3.13 e 3.12 não são suportados atualmente pelo MATLAB Engine)
• MATLAB R2024a (ou versão compatível)
• Gerenciador de pacotes uv

Instalação

1. Crie e configure o ambiente Python:

# Pin Python version
uv python pin 3.11

# Create virtual environment
uv venv

# Activate virtual environment
source .venv/bin/activate

# Install MCP
uv add "mcp[cli]"

2. Instale o MATLAB Engine O MATLAB Engine será instalado automaticamente na primeira execução do servidor, usando a instalação do MATLAB especificada na variável de ambiente MATLAB_PATH.

Estrutura de Diretórios

• matlab_server.py: A implementação principal do servidor MCP
• matlab_scripts/: Diretório onde todos os scripts e funções MATLAB são salvos (criado automaticamente)
• pyproject.toml: Configuração do projeto Python
• .python-version: Especifica a versão do Python para uv

Integração com Claude Desktop

1. Abra a configuração do seu Claude Desktop:

# On macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Adicione a configuração do servidor MATLAB:

{
    "mcpServers": {
        "matlab": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/matlab-mcp",
                "run",
                "matlab_server.py"
            ],
            "env": {
                "MATLAB_PATH": "/Applications/MATLAB_R2024a.app"
            }
        }
    }
}

Certifique-se de:

• Substituir /absolute/path/to/matlab-mcp pelo caminho real do seu diretório de projeto
• Verificar se MATLAB_PATH aponta para a sua instalação do MATLAB
• Usar caminhos absolutos (não relativos)

Recursos

O servidor fornece várias ferramentas:

1. create_matlab_script: Criar um novo arquivo de script MATLAB

   • Os scripts são salvos no diretório matlab_scripts
   • Os nomes dos arquivos devem ser identificadores MATLAB válidos

2. create_matlab_function: Criar um novo arquivo de função MATLAB

   • As funções são salvas no diretório matlab_scripts
   • Deve incluir uma definição de função válida

3. execute_matlab_script: Executar um script MATLAB e obter resultados

   • Retorna texto de saída, figuras geradas e variáveis do workspace
   • Pode passar argumentos para os scripts

4. call_matlab_function: Chamar uma função MATLAB com argumentos

   • Retorna a saída da função e quaisquer figuras geradas

Testes

Você pode testar o servidor usando o MCP Inspector:

# Make sure you're in your virtual environment
source .venv/bin/activate

# Run the inspector
MATLAB_PATH=/Applications/MATLAB_R2024a.app mcp dev matlab_server.py

Exemplo de script de teste:

t = 0:0.01:2*pi;
y = sin(t);
plot(t, y);
title('Test Plot');
xlabel('Time');
ylabel('Amplitude');

Armazenamento de Scripts

• Todos os scripts e funções MATLAB são salvos no diretório matlab_scripts
• Este diretório é criado automaticamente quando o servidor inicia
• Os arquivos são nomeados como <script_name>.m ou <function_name>.m
• O diretório está no mesmo local que matlab_server.py

Variáveis de Ambiente

• MATLAB_PATH: Caminho para a sua instalação do MATLAB
  • Padrão: /Applications/MATLAB_R2024a.app
  • Definido na configuração do Claude Desktop ou ao executar diretamente

Solução de Problemas

1. Falha na Instalação do MATLAB Engine

   • Verifique se o MATLAB_PATH está correto
   • Tente instalar o engine manualmente:

     cd $MATLAB_PATH/extern/engines/python
     python setup.py install
     

2. Problemas com a Versão do Python

   • Certifique-se de estar usando Python 3.11
   • Verifique com: python --version
   • Use uv python pin 3.11 se necessário

3. Erros na Execução de Scripts

   • Verifique se o diretório matlab_scripts existe
   • Confirme se a sintaxe do script é válida
   • Procure por mensagens de erro na saída do MATLAB

Atualizações e Manutenção

• Mantenha sua instalação do MATLAB atualizada
• Atualize os pacotes Python conforme necessário: uv pip install --upgrade mcp[cli]
• Verifique a compatibilidade do MATLAB engine ao atualizar o Python