MT5 MCP Server
MT5 MCP Server
Ein lokaler MCP-Server, der ein MetaTrader-5-Terminal mit Claude verbindet. Er liest Marktdaten, Kontostand und -historie aus, erstellt Chart-Screenshots und kann Live-Aufträge senden.
Voraussetzungen
Das MetaTrader-5-Terminal muss laufen
Extras → Optionen → Experten → „Automatischen Handel erlauben“ muss aktiviert sein
Es muss ein Konto angemeldet sein
Wenn das Terminal geschlossen ist, gibt jedes Tool MT5 initialize failed zurück – öffnen Sie es und versuchen Sie es erneut.
Related MCP server: metatrader-mcp
Installation
uv venv --python 3.12 .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txtPassen Sie dann die Pfade in .mcp.json an und starten Sie Claude Code neu.
Tools (20)
Marktdaten
Tool | Funktion |
| Terminal-Build, Verbindung, Konto, Guthaben, Eigenkapital, Marge, DEMO/REAL |
| Symbole suchen – Platzhalter werden unterstützt ( |
| Nachkommastellen, Punkt, Spread, Kontraktgröße, Lot-Grenzen, Marge und Swap-Sätze |
| Live-Geld-/Briefkurs und Spread für ein oder mehrere Symbole |
| OHLCV von M1 bis MN1, nach Anzahl oder Datumsbereich |
| Roher Geld-/Brief-Tick-Stream, nützlich für Backtests |
Konto
Tool | Funktion |
| Offene Positionen und gesamter nicht realisierter Gewinn/Verlust |
| Aktive Limit- und Stop-Orders |
| Geschlossene Geschäfte mit Gewinn, Provision und Swap-Summen |
| Orders, die platziert, storniert oder abgelehnt wurden |
| Marge und erwarteter Gewinn, bevor etwas gesendet wird (es wird keine Order platziert) |
Bildschirmaufnahme
Tool | Funktion |
| Offene Charts mit Symbol, Zeitrahmen und Größe |
| PNG des Terminalfensters oder eines einzelnen Charts |
screenshot stammt nicht aus der MetaTrader5-Python-API – diese API hat überhaupt keine Screenshot-Funktion. Es basiert auf dem Windows-PrintWindow-Aufruf (mt5_capture.py). Es funktioniert mit einem Hintergrundfenster, aber nicht mit einem minimierten.
Übergeben Sie target='window' für das gesamte Terminal oder target='XAUUSD,M30' für einen einzelnen Chart. Wenn Sie nur 'XAUUSD' übergeben, wird der größte Chart für dieses Symbol ausgewählt.
Handel – live
Tool | Funktion |
| Marktkauf/-verkauf, SL/TP als absoluter Preis oder in Punkten |
| Kauf-/Verkaufslimit oder -stop, optional mit Ablauf |
| SL/TP bei einer offenen Position ändern |
| Preis, SL oder TP bei einer schwebenden Order ändern |
| Vollständiges oder teilweises Schließen |
| Eine schwebende Order entfernen |
| Alles schließen oder nur ein Symbol |
⚠️ Es gibt keine Demo-/Echtgeld-Sperre bei den Handels-Tools. Orders gehen an das Konto, mit dem das Terminal angemeldet ist. Der Ausführungsmodus des Brokers wird automatisch erkannt und das Symbol wird bei Bedarf zur Marktbeobachtung hinzugefügt.
CLI (trade.py)
Dieselben Tools ohne Claude, direkt von der Befehlszeile aus:
.venv/Scripts/python.exe trade.py buy XAUUSD 0.01 --sl-points 500 --tp-points 1000
.venv/Scripts/python.exe trade.py modify 10090941191 --sl 4345.56 --tp 4360.56
.venv/Scripts/python.exe trade.py close 10090941191
.venv/Scripts/python.exe trade.py close-all --symbol XAUUSD
.venv/Scripts/python.exe trade.py positions
.venv/Scripts/python.exe trade.py calc buy XAUUSD 0.01 --close-price 4360Führen Sie trade.py --help für jeden Unterbefehl aus.
Zeitformat
Alle Zeiteingaben sind in UTC: YYYY-MM-DD, YYYY-MM-DD HH:MM oder YYYY-MM-DD HH:MM:SS. Auch die Ausgabezeitstempel sind in UTC.
Konfiguration
Diese Umgebungsvariablen sind in .mcp.json optional:
Variable | Zweck |
| Pfad zu |
| Bei einem anderen Konto anmelden (Standard: das, was das Terminal bereits verwendet) |
Rauchtest
.venv/Scripts/python.exe -c "import mt5_mcp_server as s; print(s.mt5_status()['account'])"This server cannot be deployed
Maintenance
Related MCP Connectors
Let AI agents trade and read MetaTrader 5 accounts. Hosted — no terminal for you to run.
Connect Claude, ChatGPT, Gemini or Grok to your broker: live charts, backtests and trades
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables comprehensive access to the MetaTrader 5 trading platform for retrieving market data, managing accounts, and executing trading operations. It provides 32 specialized tools for interacting with MT5 functionalities, including historical OHLCV data access, real-time position monitoring, and automated order management.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to capture real MetaTrader 5 chart snapshots with custom indicators and fetch market data through natural language in Claude Desktop.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with MetaTrader 5 for market data, technical analysis, Fibonacci calculations, and trading via MCP clients such as Claude.MIT
- FlicenseAqualityDmaintenanceEnables Claude AI to perform forex trading operations and market data analysis through MetaTrader 5, including order placement, position management, and multi-timeframe candle data retrieval.16-