MetaTrader 4

Integre-se à plataforma de negociação MetaTrader 4 para acessar funções e dados de negociação por meio de uma ponte HTTP e Expert Advisor.

GitHub
21
Experimente este MCPPatrocinado

Documentação

Servidor MCP MetaTrader 4

Um servidor Model Context Protocol (MCP) que fornece integração multiplataforma com a plataforma de negociação MetaTrader 4 via rede.

Autor: 8nite (8nite@qmlab.io)

Recursos

  • Informações da Conta: Obtenha detalhes da conta em tempo real (saldo, patrimônio, margem, etc.)
  • Dados de Mercado: Recupere preços de mercado atuais para símbolos de negociação
  • Gerenciamento de Ordens: Coloque ordens de mercado e pendentes
  • Gerenciamento de Posições: Visualize e feche posições abertas
  • Histórico de Negociações: Acesse dados históricos de negociação
  • Backtesting: Execute backtests em Expert Advisors com configuração detalhada
  • Gerenciamento de Expert Advisors: Liste e gerencie EAs disponíveis
  • Fallback Baseado em Arquivos: Rastreamento robusto de status e resultados quando os endpoints da API falham
  • Desenvolvimento de EA: Criação remota de EA, edição, sincronização e compilação com relatórios de erros
  • Multiplataforma: Servidor MCP Linux conecta-se ao MT4 Windows via HTTP

Arquitetura

A integração usa comunicação HTTP entre o servidor MCP e o MT4:

  1. Servidor MCP (Linux - Node.js/TypeScript) - Fornece ferramentas para o Claude Code
  2. Bridge HTTP (Windows - Node.js) - Converte solicitações HTTP em I/O de arquivos
  3. Expert Advisor MT4 (Windows - MQL4) - Lida com operações de negociação
  4. Comunicação de Rede - Troca de dados baseada em JSON via API HTTP

Configuração

1. Instale o Servidor MCP (Máquina Linux - 192.168.50.X)

npm install
npm run build

2. Instale o Bridge HTTP (Máquina Windows - 192.168.50.161)

  1. Copie a pasta windows-server/ para sua máquina Windows
  2. Instale o Node.js no Windows, se ainda não estiver instalado
  3. Navegue até a pasta windows-server e execute:
npm install
npm start
  1. O bridge HTTP iniciará na porta 8080

3. Instale o Expert Advisor MT4 (Máquina Windows)

Opção A: Ultimate MCP EA (Recomendado)

  1. Copie mcp/MCP_Ultimate.mq4 para sua pasta MQL4/Experts/ do MT4
  2. Compile o Expert Advisor no MetaEditor
  3. Anexe o Expert Advisor a qualquer gráfico no MT4
  4. Configure as entradas do EA:
    • EnableFileReporting: true (para relatórios aprimorados)
    • EnableBacktestTracking: true (para monitoramento de backtest)
    • EnableVisualMode: true (para indicadores de status no gráfico)
    • Configure as opções de rastreamento de dados de mercado conforme necessário
  5. Certifique-se de que "Permitir importação de DLL" esteja habilitado nas configurações do MT4

Opção B: EA Unificado (Legado)

  1. Copie MT4_Files/MCPBridge_Unified.mq4 para sua pasta MQL4/Experts/ do MT4
  2. Siga o mesmo processo de compilação e anexação
  3. Funcionalidade aprimorada, mas não tão abrangente quanto a versão Ultimate

Opção C: EA Básico (Legado)

  1. Copie MT4_Files/MCPBridge.mq4 para sua pasta MQL4/Experts/ do MT4
  2. Siga o mesmo processo de compilação e anexação
  3. Limitado à funcionalidade MCP básica sem relatórios aprimorados

4. Configure o Claude Code (Máquina Linux)

Adicione o servidor MCP à sua configuração do Claude Code:

claude mcp add mt4-server npm run start

Ou configure manualmente com IP personalizado:

MT4_HOST=192.168.50.161 MT4_PORT=8080 claude mcp add mt4-server npm run start

Ou nas suas configurações de MCP:

{
  "mcpServers": {
    "mt4-server": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "MT4_HOST": "192.168.50.161",
        "MT4_PORT": "8080"
      }
    }
  }
}

Uso

Uma vez configurado, você pode usar estas ferramentas no Claude Code:

Obter Informações da Conta

Use the get_account_info tool to see my MT4 account details

Obter Dados de Mercado

Get current market data for EURUSD using get_market_data

Colocar Ordens

Place a BUY order for 0.1 lots of EURUSD with stop loss at 1.0850 and take profit at 1.0950

Visualizar Posições

Show me all my open positions using get_positions

Fechar Posição

Close position with ticket number 12345

Executar Backtest

Run a backtest on MACD Sample Expert Advisor for EURUSD H1 from 2024-01-01 to 2024-12-31 with initial deposit 10000

Listar Expert Advisors

Show me all available Expert Advisors for backtesting

Obter Resultados de Backtest

Get the results from the last backtest with detailed information

Monitorar Status do Backtest

Check the current status of a running backtest

Fluxo de Trabalho de Desenvolvimento de EA

Listar EAs Locais

Show me all EAs in the active development folder

Sincronizar EA para MT4

Upload MyStrategy EA to MetaTrader for compilation

Compilar EA

Compile MyStrategy EA and show any errors or warnings

Criar Novo EA a partir de Modelo

cd ea-strategies
./develop.sh new MyNewStrategy SimpleMA_Template.mq4
./develop.sh edit MyNewStrategy

Estrutura de Arquivos

├── src/
│   └── index.ts                    # MCP server implementation
├── mcp/                            # MCP infrastructure files
│   └── MCP_Ultimate.mq4           # Ultimate unified MCP Bridge with all features
├── strategies/                     # User trading strategies (git ignored)
│   └── [User strategy EAs]        # Custom trading strategies for personal use
├── ea-strategies/                  # EA development workspace (git ignored)
│   ├── templates/                  # EA templates and examples
│   ├── active/                     # EAs under development
│   ├── compiled/                   # Successfully compiled EAs
│   ├── logs/                       # Compilation logs and error reports
│   ├── develop.sh                  # Development helper script
│   └── README.md                   # EA development guide
├── MT4_Files/                      # Legacy MCP files
│   ├── MCPBridge_Unified.mq4      # Unified MCP Bridge with enhanced reporting
│   └── MCPBridge.mq4              # Legacy MCP Bridge (basic functionality)
├── dist/                          # Compiled JavaScript
├── MCPBridge_Unified_Guide.md     # Complete setup guide for unified EA
├── bridge-endpoints-needed.md     # Required HTTP bridge endpoints
├── package.json
└── tsconfig.json

Arquivos de Dados

O Expert Advisor cria estes arquivos na pasta MQL4/Files/ do MT4:

  • account_info.txt - Informações da conta
  • market_data_[SYMBOL].txt - Dados de mercado para cada símbolo
  • positions.txt - Posições abertas
  • order_commands.txt - Comandos de ordens recebidas
  • close_commands.txt - Comandos de fechamento de posições

Relatórios Baseados em Arquivos (Novo Recurso)

Para monitoramento aprimorado de backtest, os EAs podem gravar no diretório de relatórios:

  • mt4_reports/backtest_status.json - Status e progresso do backtest em tempo real
  • mt4_reports/backtest_results.json - Resultados detalhados do backtest e estatísticas
  • mt4_reports/backtest_report.html - Relatório HTML opcional para análise detalhada

O servidor MCP automaticamente recorre à leitura desses arquivos quando os endpoints da API não estão disponíveis.

Configuração: Defina a variável de ambiente MT4_REPORTS_PATH para personalizar o diretório de relatórios (padrão: /tmp/mt4_reports)

Notas de Segurança

  • Esta integração é para uso educacional/pessoal
  • Nunca compartilhe suas credenciais de login do MT4
  • Teste minuciosamente em uma conta demo antes de usar com dinheiro real
  • A comunicação baseada em arquivos é simples, mas não criptografada

Limitações

  • A comunicação baseada em I/O de arquivos tem alguma latência
  • Limitado aos recursos da plataforma MT4
  • Requer que o MT4 esteja em execução com o Expert Advisor anexado
  • Sem dados de streaming em tempo real (apenas atualizações periódicas)

Solução de Problemas

  1. Servidor MCP não respondendo: Verifique se o MT4 está em execução com o Expert Advisor
  2. Sem dados de mercado: Certifique-se de que os símbolos estejam disponíveis no Market Watch do seu MT4
  3. Ordens não executando: Verifique se a negociação automatizada está habilitada no MT4
  4. Erros de acesso a arquivos: Verifique a configuração do caminho de dados do MT4 e as permissões de arquivo
  5. Status/resultados de backtest não disponíveis:
    • Verifique se os endpoints da API estão respondendo (o servidor recorrerá automaticamente aos arquivos)
    • Certifique-se de que o EA esteja gravando no diretório mt4_reports/ usando o modelo fornecido
    • Verifique se a variável de ambiente MT4_REPORTS_PATH está configurada corretamente
  6. Fallback baseado em arquivos não funcionando: Certifique-se de que o diretório de relatórios exista e tenha permissões adequadas

Variáveis de Ambiente

  • MT4_HOST: Endereço IP da máquina Windows executando o MT4 (padrão: 192.168.50.161)
  • MT4_PORT: Número da porta para o bridge HTTP (padrão: 8080)
  • MT4_REPORTS_PATH: Caminho do diretório para arquivos de relatório do EA (padrão: /tmp/mt4_reports)

Guia de Integração de EA

Para habilitar relatórios baseados em arquivos em seus Expert Advisors:

  1. Copie o código EA_FileReporting_Template.mq4 para o seu EA
  2. Chame WriteBacktestStatus() periodicamente durante o backtesting
  3. Chame WriteBacktestResults() quando o backtest for concluído
  4. Certifique-se de que o MT4 tenha permissões de gravação no diretório de relatórios

O servidor MCP detectará e usará automaticamente esses arquivos quando os endpoints da API falharem.

Recursos do MCP Ultimate EA

MCP_Ultimate.mq4 é a solução MCP mais abrangente, combinando toda a funcionalidade:

Principais Recursos

  • Funções Completas do Bridge MCP: Informações da conta, dados de mercado, gerenciamento de ordens
  • Relatórios Aprimorados de Backtest: Status em tempo real e resultados abrangentes em formato JSON
  • Indicadores Visuais: Exibição de status no gráfico mostrando conexão MCP e desempenho
  • Rastreamento Avançado de Dados de Mercado: Rastreamento configurável para pares principais/menores/exóticos e commodities
  • Registro Abrangente: Logs de operações detalhados com rotação automática
  • Suporte a Negociação ao Vivo: Funciona perfeitamente tanto para backtesting quanto para negociação ao vivo
  • Fallback Baseado em Arquivos: Recurso automático a relatórios baseados em arquivos quando os endpoints da API falham
  • Monitoramento de Depuração e Desempenho: Contadores de operações em tempo real e métricas de desempenho

Opções de Configuração

  • Configurações do Bridge MCP: Intervalos de atualização, alternâncias de relatórios, modo visual
  • Configuração de Relatórios: Formato JSON, logs detalhados, número máximo de arquivos de log
  • Configurações de Dados de Mercado: Rastreamento selecionável para diferentes tipos de pares de moedas

Configuração Rápida

  1. Use mcp/MCP_Ultimate.mq4 para funcionalidade completa
  2. Configure todas as opções nas entradas do EA conforme suas necessidades
  3. Funcionalidade MCP completa com feedback visual aprimorado e monitoramento

Benefícios Organizacionais

  • Infraestrutura MCP: Todos os arquivos relacionados a MCP na pasta mcp/
  • Separação de Estratégias: Estratégias do usuário na pasta strategies/ (ignorada pelo git)
  • Espaço de Trabalho de Desenvolvimento: Ferramentas de desenvolvimento de EA em ea-strategies/ (ignoradas pelo git)
  • Suporte Legado: Versões anteriores mantidas em MT4_Files/ para compatibilidade

Consulte MCPBridge_Unified_Guide.md para instruções detalhadas de configuração em versões legadas.