Servidor MCP de MetaTrader 5 (MT5) y estación de trabajo de GUI web

Un servidor Model Context Protocol (MCP) de alto rendimiento y una estación de trabajo de GUI web interactiva para MetaTrader 5 en Windows. Este proyecto conecta asistentes de IA (Antigravity, Claude Desktop, Cursor, etc.) y traders cuantitativos directamente con su instalación local de MT5 para:

1. Obtener datos históricos de mercado (barras OHLCV en marcos temporales M1–MN1 y flujos de ticks con precisión de milisegundos) con exportaciones de alta velocidad en Parquet y CSV.

2. Ejecutar backtests de estrategias mediante motores cuantitativos de Python integrados y automatización del Probador de Estrategias nativo de MT5 (terminal64.exe /config:tester.ini).

3. Inspeccionar el estado de la cuenta demo, curvas de capital, símbolos activos, cotizaciones de mercado y posiciones abiertas.

4. GUI web financiera interactiva: Construida con TradingView Lightweight Charts, telemetría en tiempo real, Strategy Studio con visualizador de curvas de capital y administrador de inicio de sesión de cuentas.

5. Estricto guardián de seguridad operativa: Garantiza que las órdenes demo y reales solo puedan ejecutarse con confirmación explícita.

Descripción general de la arquitectura

 ┌────────────────────────────────────────────────────────┐
 │                      AI Client                         │
 │        (Antigravity / Claude Desktop / Cursor)         │
 └───────────────────────────┬────────────────────────────┘
                             │ MCP Protocol (stdio)
 ┌───────────────────────────▼────────────────────────────┐
 │                  MT5 MCP Server (Python)               │
 │   - FastMCP Server (`src/mt5_mcp/server.py`)           │
 │   - Data Caching & Parquet/CSV Export Engine           │
 │   - Quantitative Strategy Backtesting Engine           │
 └─────────────┬────────────────────────────┬─────────────┘
               │                            │
 ┌─────────────▼──────────────┐  ┌──────────▼─────────────┐
 │    MetaTrader5 Python API  │  │ MT5 Native Tester Auto │
 │  - copy_rates_range()      │  │  - tester.ini builder  │
 │  - copy_ticks_range()      │  │  - terminal64.exe CLI  │
 │  - account_info() / login()│  │  - Report XML/HTML     │
 └─────────────┬──────────────┘  └──────────┬─────────────┘
               │                            │
 ┌─────────────▼────────────────────────────▼─────────────┐
 │               MetaTrader 5 Windows Terminal            │
 │               (Demo Account Connected)                 │
 └────────────────────────────────────────────────────────┘

Related MCP server: Meta-Trader-MCP

Instalación y requisitos previos

1. Requisitos

• Windows 10 / 11 (64 bits)

• Terminal de escritorio de MetaTrader 5 instalada

• Python 3.10, 3.11 o 3.12 (64 bits)

• uv (recomendado) o pip estándar

2. Habilitar el trading algorítmico en MT5

En su terminal de MetaTrader 5:

• Vaya a Herramientas -> Opciones -> Asesores expertos.

• Marque Permitir trading algorítmico.

• Marque Permitir importaciones DLL (si lo requieren indicadores personalizados).

3. Configurar el entorno virtual

# Clone the repository
git clone https://github.com/remomein05/mt5-mcp.git
cd mt5-mcp

# Create virtual environment and install dependencies
uv venv --python 3.12 .venv
.venv\Scripts\activate
uv pip install -e ".[dev]"

Estación de trabajo de GUI web (panel interactivo)

El repositorio incluye un panel de GUI web dedicado de grado financiero con gráficos de TradingView, seguimiento del mercado en tiempo real, estudio de backtesting de estrategias y gestión de cuentas:

# Launch via console script
mt5-mcp-gui

# Or launch via Python module
.venv\Scripts\python -m mt5_mcp.gui --port 8000

Luego abra http://127.0.0.1:8000 en su navegador.

Funciones de la GUI:

• 📊 TradingView Lightweight Charts: Gráficos de velas y volumen fluidos con selector interactivo de marco temporal (M1, M5, M15, M30, H1, H4, D1).

• 📈 Strategy Backtest Studio: Configure los parámetros de la estrategia (SMA Crossover, RSI Reversal, Bollinger Bands), ejecute simulaciones e inspeccione las curvas de crecimiento del capital, los KPI (ratio de Sharpe, % de retroceso máximo, % de tasa de aciertos) y los registros de operaciones cerradas.

• 📦 Exportador de datos históricos: Extracción instantánea con un clic de datos de velas a archivos Parquet y CSV.

• 🔍 Market Watch: Exploración de símbolos en tiempo real con búsqueda por comodines (p. ej. *USD*, Crypto*) e indicadores de spread flotante en vivo.

• ⚙️ Modal de conexión MT5 e inicio de sesión de cuenta: Conéctese sin problemas a su terminal MT5 activa o cambie/inicie sesión en cualquier cuenta demo con ID de inicio de sesión personalizado, contraseña, bróker/servidor y ruta de ejecutable opcional (con envío con la tecla Enter y cierre con la tecla Esc).

• 📋 Panel de posiciones abiertas y probador nativo de MT5: Vea las operaciones abiertas y automatice asesores expertos MQL5 nativos sin interfaz gráfica con configuraciones .ini por lotes.

Configuración del cliente MCP

Claude Desktop / Antigravity / Cursor (mcp_config.json)

Añada el servidor MCP de MT5 a la configuración de su cliente MCP:

{
  "mcpServers": {
    "mt5": {
      "command": "C:\\Users\\<USER>\\source\\repos\\mt5_mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "mt5_mcp.server"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Herramientas MCP disponibles

1. Gestión de conexión y cuenta

2. Exploración de mercado y datos históricos

3. Pruebas y simulación de estrategias

4. Posiciones y trading (protegido)

Ejecución de pruebas

Ejecute la completa suite de pytest que verifica la conectividad, la extracción histórica, los backtesters cuantitativos y las API REST de la GUI:

.venv\Scripts\pytest -v

Licencia

Licencia MIT.