mt5-mcp-by-leo

Servidor MCP completo para MT5: Através do protocolo MCP, permite [Trades, Ordens, Histórico, Objetos Gráficos, Logs do Terminal, Compilação, etc.]

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP Universal para Operações de Trading e Dados do MetaTrader 5

Visão Geral

FullMt5McpByLeo é um servidor MCP completo e pronto para produção que permite ao Claude e outros assistentes de IA controlar o MetaTrader 5 diretamente. Execute negociações, obtenha dados de mercado, gerencie gráficos, analise o histórico de negociações e automatize operações do MT5 por meio de linguagem natural.

Principais Recursos (Gerais)

Execução rápida; o servidor MCP é escrito em C++ usando simdjson e o MQL5 usa JsonParserByLeo (parser JSON rápido em MQL5), código ultra-otimizado para máxima velocidade. O tempo médio de resposta é de cerca de 10ms (desde quando o Claude chama uma função até sua resposta; note que isso pode depender do tamanho da solicitação... em média é 10ms).
Diferente de outros MCPs para MT5, este MCP tem duas partes, uma em MQL5 e outra em C++, dando acesso à API MQL5 completa e não limitado ao pacote mt5 para Python, que carece de funções para manipulação de gráficos, etc.

Principais Recursos (Funções MCP)

Operações de Trading

Execute e gerencie posições e ordens de negociação:

Abrir Posições: Execute negociações de mercado (compra/venda) com ordens imediatas ou pendentes
Gerenciamento de Posições: Modifique stops/profits, feche posições (total ou parcial)
Gerenciamento de Ordens: Crie, modifique e cancele ordens pendentes de limite/stop
Histórico de Negociações: Consulte negócios concluídos com análise de lucro/perda

Dados de Mercado e Símbolos

Acesse dados em tempo real e históricos:

Dados OHLC: Obtenha dados de candles (abertura, máxima, mínima, fechamento, volume, spread, etc.)
Dados de Tick: Obtenha dados de tick (último, ask, bid, flags, etc.)
Informações do Símbolo: Obtenha propriedades do símbolo (dígitos, spreads, swaps, volumes, etc. — todos os SYMBOL_INFO_*)
Market Watch: Gerencie a seleção e disponibilidade de símbolos

Indicadores

Gerenciador de Indicadores: Obtenha parâmetros, adicione indicadores (TODOS, Personalizados, MA, ETC.), remova, obtenha buffers, etc.

Objetos Gráficos

Crie e modifique visualizações de gráficos:

Desenhar Objetos: Crie linhas de tendência, retângulos, rótulos de texto, setas
Propriedades de Objetos: Modifique cores, estilos, preços, textos, todos os ENUM_OBJECT_PROPERTY_*
Anotações de Gráfico: Adicione marcadores visuais e indicadores aos gráficos

Gerenciamento de Gráficos

Controle janelas de gráficos e operações de redesenho:

Operações de Gráfico: Abra, feche, liste gráficos ativos
Propriedades de Gráfico: Leia dimensões, cores, faixas de preço do gráfico
Atualizações Visuais: Force o redesenho do gráfico para atualizações em tempo real
Indicadores: Adicione\Exclua\ObtenhaNome\ObtenhaTotal de indicadores de qualquer gráfico\subjanela
Navegação: Navegue pelo gráfico

Código e Terminal

Compile e execute Expert Advisors:

Compilação: Compile código-fonte MQL5 para bytecode EX5
Backtesting e Otimização: Execute testes históricos com múltiplos modos de modelagem de ticks\alavancagem\critérios de otimização\modo de otimização\forward\modo visual.. etc. e obtenha relatório completo, negócios, curva de saldo\equidade.
Execução de EA: Execute Expert Advisors em tempo real
Registros: Obtenha logs de EA para depuração e monitoramento
Terminal e Conta: Obtenha informações do terminal e da conta info_* (inteiro, string, double)

Nota: A versão Python do pacote mt5_mcp_by_leo está obsoleta. Agora substituída pelo servidor exe em C++. Nota: Diferente de outros MCPs que usam arquivos .ini para iniciar backtests, este MCP não precisa disso porque controla todo o testador MT5 a partir do mesmo EA, sem arquivos .ini, sem terminais desperdiçados. Além disso, a compilação de código é mais completa, pois sua IA pode escolher se otimiza o código, instruções, etc.

Estrutura do Repositório

FullMt5McpByLeo/
├── Src/                              # MQL5 Backend Functions
│    ....
├── mt5_mcp_by_leo/                   # Json tools definition
│    ....

⚠️ Ativação de Licença (Obrigatória)

Seu servidor MCP não funcionará sem uma licença ativa do TheBotPlace.

Compre o McpServerByLeo aqui: https://www.thebotplace.com/bot/mcpserverbyleo
Obtenha seu ID TBP na sua conta TheBotPlace - Seu ID de usuário
Adicione-o ao array args no seu claude_desktop_config.json ou no JSON que sua plataforma de IA usa (veja Início Rápido/passo 4 abaixo)

Requisitos (pré-instalação)

Geral (para todos)

EXE dos releases (McpServer.exe)

Para código do repositório (desenvolvedores)

Verifique: dependencies.json

Para uso do usuário:

EX5 dos releases (Runner e Mt5Mcp).

Instalação do código do repositório

cd "C:\Users\YOUR USER\AppData\Roaming\MetaQuotes\Terminal\YOUR ID\MQL5\Shared Projects"
tsndep install "https://forge.mql5.io/nique_372/FullMt5McpByLeo.git"

Para usar o comando tsndep, é necessário o pacote tsndep (disponível no pypi).. Este comando baixa automaticamente todas as dependências e instala todos os requisitos dos repositórios.
Se qualquer parte do sistema for privada, falhará... entre em contato comigo para que eu possa dar acesso (se for um produto, você pode comprá-lo; se tiver dúvidas, não hesite em me contatar).

Início Rápido (para usuários finais)

1. Download

Baixe os arquivos .exe e .ex5 mais recentes dos releases do repositório. Coloque os arquivos .ex5 na pasta Experts\ do terminal MT5, e o arquivo .exe em uma pasta de fácil acesso (por exemplo, a pasta Common\Files\ do terminal MT5).

2. Baixe tools.json

Baixe o arquivo tools.json e coloque-o na pasta Common\Files\ do seu terminal.

3. Crie um json de configuração

Abra Common\Files E crie um arquivo json com esta estrutura:

{
  "general": {
    "type_reg": "stdio_stdin",
    "json_tools_fpath": "JSON_TOOL_PATH"
  },
  "mt5_conn": {
    "host": "127.0.0.1",
    "port": 9999
  },
  "http_lib": {
    "name": "McpMt5Server",
    "version": "1.0.0",
    "host": "127.0.0.1",
    "port": 8080,
    "endpoint": "/"
  },
  "stdio_stdin": {
    "name": "MT5 MCP Server",
    "version": "1.0.0"
  }
}

Modelo completo em Templates/config.json

JSON_TOOL_PATH: Caminho para o json de configuração de ferramentas (você pode baixar o json da pasta mt5_mcp_by_leo e colocá-lo em documentos, por exemplo, e colocar o caminho para esse arquivo aqui...) Ou, se você tiver o repositório clonado, pode usar o caminho para tools.json

4. Configure no Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "mt5_mcp_by_leo": {
      "command": "PATH_TO_EXE",
      "args": ["PATH_TO_FILE", "YOUR_TBP_ID", "YOUR_MT5_ACCOUNT_LOGIN_ID" 
      ]
    }
  }
}

Modelo completo em Templates/claude_desktop_config.json

PATH_TO_EXE: Caminho para o arquivo exe McpServer.exe
PATH_TO_FILE: Caminho para o arquivo json de configuração
YOUR_TBP_ID: Seu ID de usuário do The Bot Place
YOUR_MT5_ACCOUNT_LOGIN_ID: LOGIN DA CONTA do seu MT5 onde o EA Mt5Mcp está rodando

5. Configure o MetaTrader 5

No MT5: Ferramentas → Opções → URLs permitidas para WebRequest

Adicione 127.0.0.1 ou o host que você configurou.
Clique em Aceitar
Ative AutoTrading e importações de DLL

6. Abra o Claude Desktop

Abra o Claude Desktop. Nesse momento, um CMcpServer.exe está rodando em segundo plano até estabelecer uma conexão com o EA Mt5Mcp.ex5.

7. Anexe o EA no MT5

1. Run Runner.ex5 in any chart.. (dowland from releases)
2. Drag Mt5Mcp.ex5 onto your chart (any) and cofigure it, The parameters of the EA, such as port/host, must match the JSON of Claude Desktop

8. Use no Claude

Open a 0.01 lot BUY on EURUSD with SL at 1.0800 and TP at 1.0900

Nota:

Você também pode usar HTTP Remoto (McpServer.exe suporta HTTP com libs httplib + pacote npm mcp-remote) (veja: https://forge.mql5.io/nique_372/McpServer/wiki/Running-HTTP)

Licença

Leia a Licença Completa

Ao baixar ou usar este repositório, você aceita os termos da licença.

Documentação

Wiki: https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki
Testando o MCP (Teste completo em vídeos do YT):

https://www.youtube.com/watch?v=kco7aCOs-bM

https://www.youtube.com/watch?v=xCscKpoCi3Y

Contato

Plataforma: Comunidade MQL5
Perfil: https://www.mql5.com/es/users/nique_372/news