MetaTrader 5 (MT5) MCP Server & Web GUI Workstation

Ein leistungsstarker Model Context Protocol (MCP)-Server und eine interaktive Web-GUI-Workstation für MetaTrader 5 unter Windows. Dieses Projekt verbindet KI-Assistenten (Antigravity, Claude Desktop, Cursor usw.) und quantitative Trader direkt mit ihrer lokalen MT5-Installation, um:

1. Historische Marktdaten abzurufen (OHLCV-Kerzen über alle Zeitrahmen von M1 bis MN1 sowie Tick-Streams mit Millisekunden-Präzision) mit schnellem Parquet- und CSV-Export.

2. Strategie-Backtests auszuführen über integrierte quantitative Python-Engines und native Automatisierung des MT5-Strategy-Testers (terminal64.exe /config:tester.ini).

3. Demokonto-Status einzusehen, Eigenkapitalkurven, aktive Symbole, Marktbeobachtungsnotierungen und offene Positionen.

4. Interaktive Finanz-Web-GUI: Erstellt mit TradingView Lightweight Charts, Echtzeit-Telemetrie, Strategy Studio mit Visualisierung der Eigenkapitalkurve und Kontoverwaltung für Anmeldungen.

5. Strengen Handels-Sicherheitsmechanismus: Stellt sicher, dass Demo- und Live-Aufträge nur mit ausdrücklicher Bestätigung ausgeführt werden können.

Architekturübersicht

 ┌────────────────────────────────────────────────────────┐
 │                      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

Installation & Voraussetzungen

1. Anforderungen

• Windows 10 / 11 (64-bit)

• Installiertes MetaTrader 5 Desktop-Terminal

• Python 3.10, 3.11 oder 3.12 (64-bit)

• uv (empfohlen) oder Standard-pip

2. Algorithmischen Handel in MT5 aktivieren

In Ihrem MetaTrader 5-Terminal:

• Navigieren Sie zu Tools -> Optionen -> Expert Advisors.

• Aktivieren Sie die Option Algorithmischen Handel zulassen.

• Aktivieren Sie die Option DLL-Importe zulassen (falls von benutzerdefinierten Indikatoren benötigt).

3. Virtuelle Umgebung einrichten

# 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]"

Web-GUI-Workstation (Interaktives Dashboard)

Das Repository enthält ein spezielles Web-GUI-Dashboard für den Finanzbereich mit TradingView-Charts, Echtzeit-Marktbeobachtung, Strategie-Backtesting-Studio und Kontoverwaltung:

# Launch via console script
mt5-mcp-gui

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

Öffnen Sie dann http://127.0.0.1:8000 in Ihrem Browser.

GUI-Funktionen:

• 📊 TradingView Lightweight Charts: Flüssige Kerzen- und Volumencharts mit interaktivem Zeitrahmen-Wähler (M1, M5, M15, M30, H1, H4, D1).

• 📈 Strategie-Backtesting-Studio: Konfigurieren Sie Strategieparameter (SMA Crossover, RSI Reversal, Bollinger Bands), führen Sie Simulationen aus und untersuchen Sie Equity-Wachstumskurven, KPIs (Sharpe-Ratio, maximaler Drawdown %, Gewinnrate %) und Logs abgeschlossener Geschäfte.

• 📦 Exporter für historische Daten: Sofortige Ein-Klick-Extraktion von Kerzendaten in Parquet- und CSV-Dateien.

• 🔍 Marktbeobachtung: Echtzeit-Symbole-Exploration mit Wildcard-Suche (z. B. *USD*, Crypto*) und Live-Indikatoren für variable Spreads.

• ⚙️ MT5 Connect & Account Login Modal: Nahtlose Verbindung zu Ihrem aktiven MT5-Terminal oder Wechseln/Anmelden bei einem beliebigen Demokonto mit benutzerdefinierter Anmelde-ID, Passwort, Broker/Server und optionalem Pfad zur ausführbaren Datei (mit Bestätigung per Enter-Taste und Schließen per Esc-Taste).

• 📋 Offene Positionen & natives MT5-Tester-Panel: Offene Trades anzeigen und native MQL5-Expert Advisors headless mit Batch-.ini-Konfigurationen automatisieren.

MCP-Client-Konfiguration

Claude Desktop / Antigravity / Cursor (mcp_config.json)

Fügen Sie den MT5-MCP-Server zu Ihrer MCP-Client-Konfiguration hinzu:

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

Verfügbare MCP-Tools

1. Verbindung & Kontoverwaltung

2. Markterkundung & historische Daten

3. Strategietests & Simulation

4. Positionen & Handel (Geschützt)

Tests ausführen

Führen Sie die umfassende pytest-Suite aus, die Konnektivität, historische Extraktion, quantitative Backtester und GUI-REST-APIs überprüft:

.venv\Scripts\pytest -v

Lizenz

MIT License.