MetaTrader 4

Integrarse con la plataforma de trading MetaTrader 4 para acceder a funciones y datos de trading a través de un puente HTTP y un Expert Advisor.

GitHub
17

Documentación

Servidor MCP MetaTrader 4

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración multiplataforma con la plataforma de trading MetaTrader 4 a través de la red.

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

Características

  • Información de Cuenta: Obtenga detalles de cuenta en tiempo real (saldo, equity, margen, etc.)
  • Datos de Mercado: Recupere precios de mercado actuales para símbolos de trading
  • Gestión de Órdenes: Coloque órdenes de mercado y pendientes
  • Gestión de Posiciones: Vea y cierre posiciones abiertas
  • Historial de Trading: Acceda a datos históricos de trading
  • Backtesting: Ejecute backtests en Asesores Expertos con configuración detallada
  • Gestión de Asesores Expertos: Liste y gestione los EA disponibles
  • Respaldo Basado en Archivos: Seguimiento robusto de estado y resultados cuando los endpoints de API fallan
  • Desarrollo de EA: Creación remota de EA, edición, sincronización y compilación con reporte de errores
  • Multiplataforma: El servidor MCP en Linux se conecta a MT4 en Windows mediante HTTP

Arquitectura

La integración utiliza comunicación HTTP entre el servidor MCP y MT4:

  1. Servidor MCP (Linux - Node.js/TypeScript) - Proporciona herramientas para Claude Code
  2. Puente HTTP (Windows - Node.js) - Convierte solicitudes HTTP en E/S de archivos
  3. Asesor Experto MT4 (Windows - MQL4) - Maneja las operaciones de trading
  4. Comunicación de Red - Intercambio de datos basado en JSON mediante API HTTP

Configuración

1. Instalar el Servidor MCP (Máquina Linux - 192.168.50.X)

npm install
npm run build

2. Instalar el Puente HTTP (Máquina Windows - 192.168.50.161)

  1. Copie la carpeta windows-server/ a su máquina Windows
  2. Instale Node.js en Windows si aún no está instalado
  3. Navegue a la carpeta windows-server y ejecute:
npm install
npm start
  1. El puente HTTP se iniciará en el puerto 8080

3. Instalar el Asesor Experto MT4 (Máquina Windows)

Opción A: Ultimate MCP EA (Recomendado)

  1. Copie mcp/MCP_Ultimate.mq4 a su carpeta MQL4/Experts/ de MT4
  2. Compile el Asesor Experto en MetaEditor
  3. Adjunte el Asesor Experto a cualquier gráfico en MT4
  4. Configure las entradas del EA:
    • EnableFileReporting: true (para reportes mejorados)
    • EnableBacktestTracking: true (para monitoreo de backtest)
    • EnableVisualMode: true (para indicadores de estado en el gráfico)
    • Configure las opciones de seguimiento de datos de mercado según sea necesario
  5. Asegúrese de que "Permitir importaciones DLL" esté habilitado en la configuración de MT4

Opción B: EA Unificado (Legado)

  1. Copie MT4_Files/MCPBridge_Unified.mq4 a su carpeta MQL4/Experts/ de MT4
  2. Siga el mismo proceso de compilación y adjuntado
  3. Funcionalidad mejorada pero no tan completa como la versión Ultimate

Opción C: EA Básico (Legado)

  1. Copie MT4_Files/MCPBridge.mq4 a su carpeta MQL4/Experts/ de MT4
  2. Siga el mismo proceso de compilación y adjuntado
  3. Limitado a funcionalidad MCP básica sin reportes mejorados

4. Configurar Claude Code (Máquina Linux)

Agregue el servidor MCP a su configuración de Claude Code:

claude mcp add mt4-server npm run start

O configúrelo manualmente con una IP personalizada:

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

O en su configuración de MCP:

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

Uso

Una vez configurado, puede usar estas herramientas en Claude Code:

Obtener Información de Cuenta

Use the get_account_info tool to see my MT4 account details

Obtener Datos de Mercado

Get current market data for EURUSD using get_market_data

Colocar Órdenes

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

Ver Posiciones

Show me all my open positions using get_positions

Cerrar Posición

Close position with ticket number 12345

Ejecutar 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 Asesores Expertos

Show me all available Expert Advisors for backtesting

Obtener Resultados de Backtest

Get the results from the last backtest with detailed information

Monitorear Estado de Backtest

Check the current status of a running backtest

Flujo de Trabajo de Desarrollo de EA

Listar EA Locales

Show me all EAs in the active development folder

Sincronizar EA a MT4

Upload MyStrategy EA to MetaTrader for compilation

Compilar EA

Compile MyStrategy EA and show any errors or warnings

Crear Nuevo EA desde Plantilla

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

Estructura de Archivos

├── 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

Archivos de Datos

El Asesor Experto crea estos archivos en la carpeta MQL4/Files/ de MT4:

  • account_info.txt - Información de cuenta
  • market_data_[SYMBOL].txt - Datos de mercado para cada símbolo
  • positions.txt - Posiciones abiertas
  • order_commands.txt - Comandos de órdenes entrantes
  • close_commands.txt - Comandos de cierre de posiciones

Reportes Basados en Archivos (Nueva Característica)

Para un monitoreo mejorado de backtests, los EA pueden escribir en el directorio de reportes:

  • mt4_reports/backtest_status.json - Estado y progreso de backtest en tiempo real
  • mt4_reports/backtest_results.json - Resultados detallados de backtest y estadísticas
  • mt4_reports/backtest_report.html - Reporte HTML opcional para análisis detallado

El servidor MCP automáticamente recurre a la lectura de estos archivos cuando los endpoints de API no están disponibles.

Configuración: Establezca la variable de entorno MT4_REPORTS_PATH para personalizar el directorio de reportes (predeterminado: /tmp/mt4_reports)

Notas de Seguridad

  • Esta integración es para uso educativo/personal
  • Nunca comparta sus credenciales de inicio de sesión de MT4
  • Pruebe a fondo en una cuenta demo antes de usar con dinero real
  • La comunicación basada en archivos es simple pero no está cifrada

Limitaciones

  • La comunicación basada en E/S de archivos tiene cierta latencia
  • Limitado a las capacidades de la plataforma MT4
  • Requiere que MT4 esté ejecutándose con el Asesor Experto adjunto
  • Sin datos de streaming en tiempo real (solo actualizaciones periódicas)

Solución de Problemas

  1. El servidor MCP no responde: Verifique que MT4 esté ejecutándose con el Asesor Experto
  2. Sin datos de mercado: Asegúrese de que los símbolos estén disponibles en su Market Watch de MT4
  3. Las órdenes no se ejecutan: Verifique que el trading automatizado esté habilitado en MT4
  4. Errores de acceso a archivos: Revise la configuración de la ruta de datos de MT4 y los permisos de archivos
  5. Estado/resultados de backtest no disponibles:
    • Verifique si los endpoints de API están respondiendo (el servidor recurrirá automáticamente a los archivos)
    • Asegúrese de que el EA esté escribiendo en el directorio mt4_reports/ usando la plantilla proporcionada
    • Verifique que la variable de entorno MT4_REPORTS_PATH esté configurada correctamente
  6. El respaldo basado en archivos no funciona: Asegúrese de que el directorio de reportes exista y tenga los permisos adecuados

Variables de Entorno

  • MT4_HOST: Dirección IP de la máquina Windows que ejecuta MT4 (predeterminado: 192.168.50.161)
  • MT4_PORT: Número de puerto para el puente HTTP (predeterminado: 8080)
  • MT4_REPORTS_PATH: Ruta del directorio para archivos de reporte del EA (predeterminado: /tmp/mt4_reports)

Guía de Integración de EA

Para habilitar los reportes basados en archivos en sus Asesores Expertos:

  1. Copie el código EA_FileReporting_Template.mq4 en su EA
  2. Llame a WriteBacktestStatus() periódicamente durante el backtesting
  3. Llame a WriteBacktestResults() cuando el backtest se complete
  4. Asegúrese de que MT4 tenga permisos de escritura en el directorio de reportes

El servidor MCP detectará y usará automáticamente estos archivos cuando los endpoints de API fallen.

Características del MCP Ultimate EA

MCP_Ultimate.mq4 es la solución MCP más completa que combina toda la funcionalidad:

Características Clave

  • Funciones Completas de Puente MCP: Información de cuenta, datos de mercado, gestión de órdenes
  • Reportes de Backtest Mejorados: Estado en tiempo real y resultados completos en formato JSON
  • Indicadores Visuales: Visualización de estado en el gráfico que muestra la conexión MCP y el rendimiento
  • Seguimiento Avanzado de Datos de Mercado: Seguimiento configurable para pares mayores/menores/exóticos y materias primas
  • Registro Completo: Registros de operaciones detallados con rotación automática
  • Soporte de Trading en Vivo: Funciona sin problemas tanto para backtesting como para trading en vivo
  • Respaldo Basado en Archivos: Recurso automático a reportes basados en archivos cuando los endpoints de API fallan
  • Monitoreo de Depuración y Rendimiento: Contadores de operaciones en tiempo real y métricas de rendimiento

Opciones de Configuración

  • Configuración del Puente MCP: Intervalos de actualización, alternadores de reportes, modo visual
  • Configuración de Reportes: Formato JSON, registros detallados, número máximo de archivos de registro
  • Configuración de Datos de Mercado: Seguimiento seleccionable para diferentes tipos de pares de divisas

Configuración Rápida

  1. Use mcp/MCP_Ultimate.mq4 para funcionalidad completa
  2. Configure todas las opciones en las entradas del EA según sus necesidades
  3. Funcionalidad MCP completa con retroalimentación visual mejorada y monitoreo

Beneficios de Organización

  • Infraestructura MCP: Todos los archivos relacionados con MCP en la carpeta mcp/
  • Separación de Estrategias: Estrategias de usuario en la carpeta strategies/ (ignorada por git)
  • Espacio de Trabajo de Desarrollo: Herramientas de desarrollo de EA en ea-strategies/ (ignorada por git)
  • Soporte Legado: Versiones anteriores mantenidas en MT4_Files/ para compatibilidad

Consulte MCPBridge_Unified_Guide.md para instrucciones detalladas de configuración de versiones legadas.