mt5-mcp-by-leo

Servidor MCP completo para MT5: A través del protocolo MCP, permite [Operaciones, Órdenes, Historial, Objetos Gráficos, Registros del Terminal, Compilación, etc.]

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP Universal para Operaciones de Trading y Datos de MetaTrader 5

Descripción general

FullMt5McpByLeo es un servidor MCP completo y listo para producción que permite a Claude y otros asistentes de IA controlar MetaTrader 5 directamente. Ejecuta operaciones, recupera datos de mercado, gestiona gráficos, analiza el historial de trading y automatiza operaciones de MT5 mediante lenguaje natural.

Características principales (General)

Ejecución rápida; el servidor MCP está escrito en C++ usando simdjson y MQL5 usa JsonParserByLeo (parser JSON rápido para MQL5), código ultraoptimizado para máxima velocidad. El tiempo de respuesta promedio es de alrededor de 10 ms (desde que Claude llama a una función hasta su respuesta; ten en cuenta que esto puede depender del tamaño de la solicitud... en promedio es de 10 ms).
A diferencia de otros MCP para MT5, este MCP tiene dos partes, una en MQL5 y la otra en C++, dando acceso a la API completa de MQL5 y no limitado al paquete mt5 para Python, que carece de funciones para manejar gráficos, etc.

Características principales (Funciones del MCP)

Operaciones de trading

Ejecuta y gestiona posiciones y órdenes de trading:

Abrir posiciones: Ejecuta operaciones de mercado (compra/venta) con órdenes inmediatas o pendientes
Gestión de posiciones: Modifica stops/beneficios, cierra posiciones (totales o parciales)
Gestión de órdenes: Crea, modifica y cancela órdenes pendientes de límite/stop
Historial de trading: Consulta operaciones completadas con análisis de ganancias/pérdidas

Datos de mercado y símbolos

Accede a datos en tiempo real e históricos:

Datos OHLC: Recupera datos de velas (apertura, máximo, mínimo, cierre, volumen, spread, etc.)
Datos de ticks: Recupera datos de ticks (último, ask, bid, flags, etc.)
Información de símbolos: Obtén propiedades de símbolos (dígitos, spreads, swaps, volúmenes, etc. — todos los SYMBOL_INFO_*)
Market Watch: Gestiona la selección y disponibilidad de símbolos

Indicadores

Gestor de indicadores: Obtén parámetros, añade indicadores (TODOS, Personalizados, MA, etc.), elimina, obtén buffers, etc.

Objetos gráficos

Crea y modifica visualizaciones de gráficos:

Dibujar objetos: Crea líneas de tendencia, rectángulos, etiquetas de texto, flechas
Propiedades de objetos: Modifica colores, estilos, precios, texto, todos los ENUM_OBJECT_PROPERTY_*
Anotaciones de gráficos: Añade marcadores visuales e indicadores a los gráficos

Gestión de gráficos

Controla ventanas de gráficos y operaciones de redibujado:

Operaciones de gráficos: Abre, cierra, lista gráficos activos
Propiedades de gráficos: Lee dimensiones, colores, rangos de precios
Actualizaciones visuales: Fuerza el redibujado del gráfico para actualizaciones en tiempo real
Indicadores: Añadir\Eliminar\ObtenerNombre\ObtenerTotal de indicadores de cualquier gráfico\subventana
Navegación: Navega por el gráfico

Código y terminal

Compila y ejecuta Asesores Expertos:

Compilación: Compila código fuente MQL5 a bytecode EX5
Backtesting y optimización: Ejecuta pruebas históricas con múltiples modos de modelado de ticks\apalancamiento\criterios de optimización\modo de optimización\forward\modo visual, etc., y obtén el informe completo, operaciones, curva de balance\equidad.
Ejecución de EA: Ejecuta Asesores Expertos en tiempo real
Registros: Recupera registros de EA para depuración y monitoreo
Terminal y cuenta: Obtén información de terminal y cuenta info_* (entero, cadena, doble)

Nota: El paquete de la versión Python mt5_mcp_by_leo está obsoleto. Ahora se reemplaza por el servidor exe en C++. Nota: A diferencia de otros MCP que usan archivos .ini para lanzar backtests, este MCP no lo necesita porque controla todo el tester de MT5 desde el mismo EA, sin archivos .ini, sin terminales desperdiciadas. Además, la compilación de código es más completa ya que su IA puede elegir si optimizar o no el código, las instrucciones, etc.

Estructura del repositorio

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

⚠️ Activación de licencia (requerida)

Tu servidor MCP no funcionará sin una licencia activa de TheBotPlace.

Compra McpServerByLeo aquí: https://www.thebotplace.com/bot/mcpserverbyleo
Obtén tu ID de TBP desde tu cuenta de TheBotPlace - Tu ID de usuario
Añádelo al array args en tu claude_desktop_config.json o en el JSON que usa tu plataforma de IA (consulta Inicio rápido/paso 4 a continuación)

Requisitos (preinstalación)

General (para todos)

EXE de releases (McpServer.exe)

Para el código del repositorio (desarrolladores)

Consulta: dependencies.json

Para uso del usuario:

EX5 de releases (Runner y Mt5Mcp).

Instalación del código del repositorio

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 el comando tsndep se requiere el paquete tsndep (disponible en pypi).. Este comando descarga automáticamente todas las dependencias e instala todos los requisitos de los repositorios.
Si alguna parte del sistema es privada, fallará... contáctame para darte acceso (si es un producto, puedes comprarlo; si tienes alguna pregunta, no dudes en contactarme).

Inicio rápido (para usuarios finales)

1. Descarga

Descarga los archivos .exe y .ex5 más recientes del repositorio releases. Coloca los archivos .ex5 en la carpeta Experts\ del terminal MT5, y el archivo .exe en una carpeta de fácil acceso (por ejemplo, la carpeta Common\Files\ del terminal MT5).

2. Descarga tools.json

Descarga el archivo tools.json y colócalo en la carpeta Common\Files\ de tu terminal.

3. Crea un json de configuración

Abre Common\Files Y crea un archivo json con esta estructura:

{
  "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"
  }
}

Plantilla completa en Templates/config.json

JSON_TOOL_PATH: Ruta al json de configuración de herramientas (puedes descargar el json de la carpeta mt5_mcp_by_leo y colocarlo en documentos, por ejemplo, y poner la ruta a dicho archivo aquí...) O si tienes el repositorio clonado, puedes usar la ruta a tools.json

4. Configura en Claude Desktop

Añade a tu 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" 
      ]
    }
  }
}

Plantilla completa en Templates/claude_desktop_config.json

PATH_TO_EXE: Ruta al archivo exe McpServer.exe
PATH_TO_FILE: Ruta al archivo json de configuración
YOUR_TBP_ID: Tu ID de usuario de The Bot Place
YOUR_MT5_ACCOUNT_LOGIN_ID: ACCOUNT_LOGGIN de tu cuenta mt5 donde se ejecuta el EA Mt5Mcp

5. Configura MetaTrader 5

En MT5: Herramientas → Opciones → URLs permitidas para WebRequest

Añade 127.0.0.1 o el host que configuraste.
Haz clic en Aceptar
Habilita AutoTrading e importaciones de DLL

6. Abre Claude Desktop

Abre Claude Desktop. En ese momento, CMcpServer.exe se ejecuta en segundo plano hasta que establece una conexión con el EA Mt5Mcp.ex5.

7. Adjunta el EA en 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. Usa en Claude

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

Nota:

También puedes usar HTTP Remote (McpServer.exe soporta HTTP con las librerías httplib + el paquete npm mcp-remote) (consulta: https://forge.mql5.io/nique_372/McpServer/wiki/Running-HTTP)

Licencia

Lee la licencia completa

Al descargar o usar este repositorio, aceptas los términos de la licencia.

Documentación

Wiki: https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki
Pruebas del MCP (Pruebas completas en videos de YT):

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

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

Contacto

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