IBKR MCP Server
IBKR MCP-Server
Ein Model Context Protocol (MCP)-Server, der KI-Modellen über die TWS-API sicheren Zugriff auf Handelsdaten und Funktionen von Interactive Brokers (IBKR) bietet.
⚠️⚠️⚠️ Haftungsausschluss ⚠️⚠️⚠️
Diese Software dient zu Bildungs- und Entwicklungszwecken. Die Nutzung erfolgt auf eigenes Risiko. Die Autoren sind nicht für finanzielle Verluste verantwortlich, die durch die Nutzung dieser Software entstehen. Testen Sie immer mit einem Paper-Trading-Konto, bevor Sie echtes Geld verwenden.
Related MCP server: Interactive Brokers MCP Server
🚀 Funktionen
Kontoverwaltung: Abrufen von Positionen, Portfoliodetails und Kontozusammenfassungen
Marktdaten: Abrufen historischer Preisdaten und Echtzeit-Marktinformationen
Handelsoperationen: Platzieren von Aufträgen, Verwalten von Positionen und Nachverfolgen von Ausführungen
MCP-Integration: Nahtlose Integration mit KI-Modellen, die das MCP-Protokoll unterstützen
One-Shot-CLI: Verbinden-Ausführen-Trennen pro Befehl für schnelles Scripting
Automatisierter TWS-Start (macOS): Ein Befehl zum Starten von TWS und automatischen Ausfüllen der TOTP-2FA
Claude Code Skill: Handel per natürlicher Sprache über das mitgelieferte
skills/ibkr-tradingSicherheitsfunktionen: Schreibgeschützter Modus, konfigurierbare Handelsbeschränkungen und umfassende Validierung
Hohe Verfügbarkeit: Automatische Wiederverbindung, Heartbeat-Überwachung und saubere Fehlerbehandlung
📋 Voraussetzungen
Python 3.10+
Interactive Brokers TWS oder IB Gateway
Aktives IBKR-Konto (Paper-Trading für Tests empfohlen)
🛠️ Installation
Repository klonen:
git clone https://github.com/happy-shine/ibkr_mcp.git cd ibkr_mcpAbhängigkeiten installieren:
pip install -r requirements.txtTWS/IB Gateway konfigurieren:
API-Verbindungen in den TWS/Gateway-Einstellungen aktivieren
Socket-Port festlegen (Standard: 7497 für Paper-Trading, 7496 für Live)
Vertrauenswürdige IP-Adressen bei Bedarf konfigurieren
Server konfigurieren:
cp config/config.yaml.example config/config.yaml # Edit config/config.yaml with your settings
🚀 Verwendung
Option A: MCP-Server
python run.pyDer Server wird:
Eine Verbindung zu TWS/IB Gateway herstellen
Den MCP-Server auf dem konfigurierten Port starten
Die Heartbeat-Überwachung beginnen
Alle Aktivitäten protokollieren
Option B: One-Shot-CLI
Leichtgewichtige CLI, die pro Befehl eine Verbindung herstellt und sich wieder beendet – gut geeignet für Shell-Skripte oder Ad-hoc-Abfragen.
python cli.py positions
python cli.py summary
python cli.py quote AAPL
python cli.py history AAPL --duration "1 M" --bar "1 day"
python cli.py buy AAPL 10 --type MKT --confirm
python cli.py ordersFühren Sie python cli.py --help für die vollständige Befehlsliste aus.
Hinweis zu Kursdaten: Wenn Sie kein Live-Marktdaten-Abonnement haben, greift
quoteauf den aktuellsten Tagesbalken über historische Daten zurück (keine Echtzeit-Felder).
Option C: Automatisierter TWS-Start (nur macOS)
start_tws.py startet TWS über IBC, erkennt den Dialog für die Zwei-Faktor-Authentifizierung, generiert einen TOTP-Code mit pyotp und gibt ihn per AppleScript (osascript) ein – vollautomatischer Login, ohne die Tastatur zu berühren.
python start_tws.py # launch and auto-fill 2FA
python start_tws.py --wait # also block until API port 7496 is listeningAnforderungen (macOS):
Komponente | Zweck | Link |
Automatisiert TWS-Start & Login-Eingaben | ||
RFC 6238 TOTP-Code-Generierung | ||
| Mit macOS geliefert; steuert den 2FA-Dialog | eingebaut |
Einrichtung:
Installieren Sie IBC gemäß den macOS-Anweisungen (normalerweise unter
~/ibc/).Setzen Sie in
~/ibc/config.ini:TradingMode=live(oderpaper)SecondFactorDevice=Mobile AuthenticatorIhre IBKR-Zugangsdaten
Speichern Sie Ihr IBKR-TOTP-Geheimnis (die Base32-Zeichenfolge aus dem QR-Code des Authenticators) in
~/.ibkr-totp-secretoder exportieren Sie es alsTOTP_SECRET.Erteilen Sie dem Terminal (oder Ihrem Python-Launcher) die Berechtigung für Bedienungshilfen unter Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen – erforderlich, damit AppleScript mit dem TWS-Fenster interagieren kann.
Plattform-Hinweis:
start_tws.pybasiert auf AppleScript/osascriptund ist nur für macOS. Linux/Windows-Benutzer sollten entweder direkt IBC verwenden oder die GUI-Automatisierungsschicht anpassen (z. B.xdotoolunter Linux,pywinautounter Windows).
Verfügbare MCP-Tools
Kontowerkzeuge
get_positions()- Aktuelle Kontopositionen abrufenget_account_summary()- Kontostand und Kennzahlen abrufenget_portfolio()- Detaillierte Portfolioinformationen abrufen
Marktdatenwerkzeuge
get_historical_data(symbol, duration, bar_size)- Historische Preisdaten abrufenget_market_data(symbol)- Echtzeit-Marktdaten abrufenget_quote_from_history(symbol)- Letzter Tagesbalken als Kurs (kein Abonnement erforderlich)get_contract_details(symbol)- Vertragsspezifikationen abrufenget_option_chain- Optionsdaten abrufen
Handelswerkzeuge
place_order(symbol, action, quantity, order_type, ...)- Kauf-/Verkaufsaufträge platzierenget_orders(status)- Auftragshistorie und Status abrufencancel_order(order_id)- Ausstehende Aufträge stornierenget_trades()- Ausführungshistorie abrufen
Beispiel-KI-Interaktionen
AI: "What are my current positions?"
→ Calls get_positions() tool
AI: "Buy 100 shares of AAPL at market price"
→ Calls place_order(symbol="AAPL", action="BUY", quantity=100, order_type="MKT")
AI: "Show me AAPL's price history for the last week"
→ Calls get_historical_data(symbol="AAPL", duration="1 W", bar_size="1 day")🤖 Claude Code Skill
Ein begleitender Skill befindet sich unter skills/ibkr-trading/SKILL.md. Er ermöglicht es Claude Code, die oben genannten CLI-Befehle über Prompts in natürlicher Sprache auszuführen (z. B. "zeige meine Positionen", "kurs von AAPL").
Zur Installation verknüpfen Sie ihn symbolisch mit Ihrem Claude Code Skills-Verzeichnis:
ln -s "$(pwd)/skills/ibkr-trading" ~/.claude/skills/ibkr-trading🔗 Verwandte Links & Credits
Interactive Brokers TWS API — offizielle Python-API (
ibapi)IBC — Interactive Brokers Controller — TWS-Autostarter (verwendet von
start_tws.py)pyotp — TOTP/HOTP-Bibliothek (verwendet von
start_tws.py)Claude Code — KI-Pair-Programming-CLI, die den gebündelten Skill nutzt
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Unified financial infrastructure connecting AI agents directly to trade live/demo brokerage accounts, Web3 non-custodial wallets, real-time market data across equities, ETFs, crypto, forex, options, DeFi swaps, and prediction markets, institutional research feeds, and algorithmic strategy backtesters.
Agentic brokerage access to a US brokerage account: quotes, orders, positions, cash and documents.
Connect AI agents to bank accounts, transactions, balances, and investments.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with Interactive Brokers trading accounts to retrieve market data, check positions, and place trades. Includes pre-configured IB Gateway and handles OAuth authentication automatically.14161 npm228MIT
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to Interactive Brokers for intelligent portfolio management, options analysis, risk monitoring, and automated trading strategy suggestions. Enables real-time account tracking, Greeks calculations, option chain analysis, and playbook-based risk adjustments through natural language.5-
- AlicenseNot gradedqualityBmaintenanceEnables read-only access to Interactive Brokers data including contracts, market data, news, fundamentals, and portfolio/account information for LLM workflows and autonomous agents.19BSD 3-Clause
- AlicenseAqualityDmaintenanceEnables AI agents to trade on Interactive Brokers: check quotes, balance, positions, and execute buy/sell orders (including fractional shares by dollar amount) via the Client Portal API.2015MIT