Interactive Brokers MCP-Server

HAFTUNGSAUSSCHLUSS: Dies ist ein inoffizieller, von der Community entwickelter MCP-Server und ist NICHT mit Interactive Brokers verbunden oder von diesen unterstützt. Diese Software befindet sich im Alpha-Status und funktioniert möglicherweise nicht einwandfrei.

Ein Model Context Protocol (MCP)-Server, der eine Integration mit der Handelsplattform von Interactive Brokers ermöglicht. Dieser Server erlaubt es KI-Assistenten, mit Ihrem IB-Konto zu interagieren, um Marktdaten abzurufen, Positionen zu prüfen und Trades zu platzieren.

🔒 Sicherheitshinweis

Related MCP server: Interactive Brokers MCP Server

Funktionen

• Interactive Brokers API-Integration: Umfassende Handelsfunktionen, einschließlich Kontoverwaltung, Positionsverfolgung, Echtzeit-Marktdaten und Auftragsverwaltung (Market-, Limit- und Stop-Orders)

• Flex Query-Unterstützung: Führen Sie Flex Queries aus, um Kontoauszüge, Handelsbestätigungen und historische Daten abzurufen. Abfragen werden automatisch für eine einfache Wiederverwendung gespeichert

• Flexible Authentifizierung: Wählen Sie zwischen browserbasierter OAuth-Authentifizierung oder einem Headless-Modus mit Anmeldedaten für automatisierte Umgebungen

• Einfache Einrichtung: Direkte Ausführung mit npx - keine Docker- oder zusätzlichen Installationen erforderlich. Enthält ein vorkonfiguriertes IB Gateway und eine Java-Laufzeitumgebung für alle Plattformen

Sicherheitshinweis

WICHTIGE WARNHINWEISE:

• Finanzielles Risiko: Der Handel ist mit erheblichen Verlustrisiken verbunden. Testen Sie immer zuerst mit einem Demokonto (Paper Trading).

• Sicherheit: Diese Software verarbeitet sensible Finanzdaten. Nur lokal ausführen, niemals auf öffentlichen Servern.

• Keine Gewährleistung: Diese inoffizielle Software wird ohne jegliche Gewährleistung bereitgestellt. Nutzung auf eigene Gefahr.

• Keine Finanzberatung: Dieses Tool dient nur der Automatisierung, nicht der Finanzberatung.

Voraussetzungen

Keine zusätzlichen Installationen erforderlich! Dieses Paket enthält:

• Vorkonfiguriertes IB Gateway für alle Plattformen (Linux, macOS, Windows)

• Java Runtime Environment (JRE) für das IB Gateway, einschließlich eines musl-libc-Builds für Alpine-basierte Container (z. B. node:lts-alpine, supergateway)

• Alle notwendigen Abhängigkeiten

Sie benötigen lediglich:

• Ein Interactive Brokers-Konto (Paper Trading oder Live-Handel)

• Node.js 18+ (zum Ausführen des MCP-Servers)

Schnellstart

Fügen Sie diesen MCP-Server zu Ihrer Cursor/Claude-Konfiguration hinzu:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"]
    }
  }
}

Wenn Sie den Server zum ersten Mal verwenden, öffnet sich automatisch ein Webbrowser-Fenster für den OAuth-Authentifizierungsablauf von Interactive Brokers. Melden Sie sich mit Ihren IB-Anmeldedaten an, um die Verbindung zu autorisieren.

Konfiguration des Headless-Modus

Für automatisierte Umgebungen oder wenn Sie die Authentifizierung lieber ohne Browser durchführen möchten, können Sie den Headless-Modus in Ihrer MCP-Serverkonfiguration aktivieren:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

Im Headless-Modus authentifiziert sich der Server automatisch mit Ihren Anmeldedaten, ohne ein Browserfenster zu öffnen. Dies ist nützlich für:

• Automatisierte Handelssysteme

• Serverumgebungen ohne Anzeige

• CI/CD-Pipelines

• Situationen, in denen keine Browserinteraktion gewünscht ist

Wichtig: Auch im Headless-Modus kann Interactive Brokers eine Zwei-Faktor-Authentifizierung (2FA) erfordern. Wenn 2FA ausgelöst wird, wartet die Headless-Authentifizierung darauf, dass Sie den 2FA-Prozess über Ihre konfigurierte Methode (mobile App, SMS usw.) abschließen, bevor sie fortfährt.

Um Paper Trading zu aktivieren, fügen Sie "IB_PAPER_TRADING": "true" zu Ihren Umgebungsvariablen hinzu:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

Sicherheitshinweis: Speichern Sie Anmeldedaten sicher und übertragen Sie diese niemals in die Versionskontrolle. Erwägen Sie die Verwendung von Umgebungsvariablendateien oder sicheren Systemen zur Verwaltung von Anmeldedaten.

Flex Query-Konfiguration (Optional)

Um Flex Queries zum Abrufen von Kontoauszügen und historischen Daten zu verwenden, müssen Sie Ihr Flex Web Service-Token konfigurieren:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_FLEX_TOKEN": "your_flex_token_here"
      }
    }
  }
}

So erhalten Sie Ihr Flex-Token:

1. Melden Sie sich bei der Interactive Brokers Kontoverwaltung an

2. Gehen Sie zu Einstellungen → Kontoeinstellungen

3. Navigieren Sie zu Berichte → Flex Web Service

4. Generieren oder rufen Sie Ihr Flex Web Service-Token ab

Detaillierte Anweisungen zur Aktivierung des Flex Web Service finden Sie im IB Flex Web Service Guide.

Erstellen von Flex Queries:

1. Gehen Sie in der Kontoverwaltung zu Berichte → Flex Queries

2. Erstellen oder passen Sie Ihre Abfragevorlage an

3. Klicken Sie auf das Info-Symbol neben Ihrer Abfrage, um die Abfrage-ID (Query ID) zu finden

Einen vollständigen Leitfaden zum Erstellen und Anpassen von Flex Queries finden Sie im IB Flex Queries Guide.

Hinweis: Wenn Sie eine Flex Query zum ersten Mal ausführen, speichert der MCP-Server sie automatisch mit ihrem Namen aus der API. Zukünftige Ausführungen können sich auf die Abfrage entweder über ihre ID oder ihren gespeicherten Namen beziehen.

Flex Query-Funktionen:

• Automatischer Speicher: Wenn Sie eine Flex Query ausführen, wird sie automatisch für die zukünftige Verwendung gespeichert

• Einfache Wiederverwendung: Zuvor verwendete Abfragen werden gespeichert – kein wiederholtes Kopieren von Abfrage-IDs erforderlich

• Benutzerfreundliche Namen: Geben Sie optional einen benutzerfreundlichen Namen an, wenn Sie eine Abfrage zum ersten Mal ausführen

• Abfragen vergessen: Entfernen Sie Abfragen, die Sie nicht mehr benötigen, mit dem Tool forget_flex_query

Konfigurationsvariablen

Verfügbare MCP-Tools

Handel & Kontoverwaltung

Flex Queries (erfordert IB_FLEX_TOKEN)

Fehlerbehebung

Authentifizierungsprobleme:

• Verwenden Sie die Weboberfläche, die sich automatisch öffnet

• Schließen Sie eine eventuell erforderliche Zwei-Faktor-Authentifizierung ab

• Versuchen Sie den Paper Trading-Modus, falls der Live-Handel fehlschlägt

Support

• Dieser Server: Erstellen Sie ein Issue in diesem Repository.

Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details.

Dank an unsere Mitwirkenden

Ein großes Dankeschön an alle, die dazu beigetragen haben, dieses Projekt zu verbessern.