TradingView MCP Bridge

Persönlicher KI-Assistent für deine TradingView-Desktop-Charts. Verbindet Claude Code mit deiner lokal laufenden TradingView-App über das Chrome DevTools Protocol für KI-gestützte Chart-Analyse, Pine-Script-Entwicklung und Workflow-Automatisierung.

[!WARNING] Dieses Tool ist nicht mit TradingView Inc. verbunden, wird von ihr nicht unterstützt und steht in keiner Verbindung zu ihr. Es interagiert über das Chrome DevTools Protocol mit deiner lokal laufenden TradingView-Desktop-Anwendung. Lies vor der Verwendung den Haftungsausschluss.

[!IMPORTANT] Erfordert ein gültiges TradingView-Abonnement. Dieses Tool umgeht oder unterläuft keine TradingView-Bezahlschranke oder Zugriffskontrolle. Es liest aus der und steuert die TradingView-Desktop-App, die bereits auf deinem Rechner läuft.

[!NOTE] Die gesamte Datenverarbeitung erfolgt lokal auf deinem Rechner. Es werden keine TradingView-Daten von diesem Tool extern übertragen, gespeichert oder weiterverteilt.

[!CAUTION] Dieses Tool greift über die Electron-Debug-Schnittstelle auf undokumentierte interne TradingView-APIs zu. Diese können sich ohne Vorankündigung in jedem TradingView-Update ändern oder brechen. Fixiere deine TradingView-Desktop-Version, wenn dir Stabilität wichtig ist.

So funktioniert es (und warum es sicher ist)

Dieses Tool verbindet sich nicht mit den Servern von TradingView, verändert keine TradingView-Dateien und fängt keinen Netzwerkverkehr ab. Es kommuniziert ausschließlich mit deiner lokal laufenden TradingView-Desktop-Instanz über das Chrome DevTools Protocol (CDP) – eine standardmäßige Debug-Schnittstelle, die in allen Chromium-/Electron-Anwendungen von Google eingebaut ist, einschließlich VS Code, Slack und Discord.

Der Debug-Port ist standardmäßig deaktiviert und muss von dir explizit mit einem standardmäßigen Chromium-Flag (--remote-debugging-port=9222) aktiviert werden. Ohne diesen bewussten Schritt passiert nichts.

Related MCP server: TradingView MCP Bridge

Was dieses Tool nicht tut

• Stellt keine Verbindung zu den Servern oder APIs von TradingView her

• Speichert, überträgt oder verteilt keine Marktdaten weiter

• Funktioniert nicht ohne gültiges TradingView-Abonnement und installierte Desktop-App

• Umgeht keine TradingView-Bezahlschranke oder Zugriffsbeschränkung

• Führt keine echten Trades aus (nur Chart-Interaktion)

• Funktioniert nicht, wenn TradingView ihre interne Electron-Struktur ändert

Forschungskontext

Dieses Projekt untersucht eine offene Forschungsfrage: Wie können LLM-basierte Agenten mit professionellen Handelsoberflächen interagieren, um menschliche Entscheidungsfindung zu unterstützen?

Konkret untersucht es:

• Wie strukturierte Tool-APIs (MCP) LLMs und zustandsbehaftete Desktop-Finanzanwendungen verbinden können

• Welche Latenz-, Kontext- und Zuverlässigkeitsbeschränkungen entstehen, wenn ein Agent mit Live-Chartdaten arbeitet

• Wie Agenten mit mehrdeutigem Finanz-UI-Zustand umgehen (z. B. Interpretation von Pine-Script-Ausgaben, Lesen von Indikator-Tabellen)

• Ob natürliche Sprache eine effektive Schnittstelle für Chart-Navigation und Pine-Script-Entwicklung ist

• Die Fehlermodi von LLM-Agenten, die in Echtzeit-Datenumgebungen arbeiten

Dies ist kein Trading-Bot. Es ist eine Schnittstellenschicht, die eine Handelsanwendung für einen LLM-Agenten lesbar macht und es Forschern und Entwicklern ermöglicht, die Mensch-KI-Zusammenarbeit in Finanz-Workflows zu untersuchen.

Siehe RESEARCH.md für offene Fragen, Erkenntnisse und verwandte Arbeiten.

Voraussetzungen

• TradingView-Desktop-App (kostenpflichtiges Abonnement für Echtzeitdaten erforderlich)

• Node.js 18+

• Claude Code mit MCP-Unterstützung (für MCP-Tools) oder ein beliebiges Terminal (für CLI)

• macOS, Windows oder Linux

Was es tut

Gibt deinem KI-Assistenten Augen und Hände für deinen eigenen Chart:

• Pine-Script-Entwicklung – Skripte mit KI-Unterstützung schreiben, injizieren, kompilieren, debuggen und iterieren

• Chart-Navigation – Symbole, Zeitrahmen ändern, zu Daten zoomen, Indikatoren hinzufügen/entfernen

• Visuelle Analyse – Indikatorwerte, Preisniveaus und Annotationen deines Charts lesen

• Auf Charts zeichnen – Trendlinien, horizontale Linien, Rechtecke, Textannotationen

• Alerts verwalten – Preisalerts erstellen, auflisten und löschen

• Replay-Übung – Schrittweise durch historische Balken gehen, Ein-/Ausstiege üben

• Screenshots – Chartzustand für KI-Visualanalyse erfassen

• Mehrfenster-Layouts – 2x2-, 3x1- usw. Raster mit verschiedenen Symbolen pro Fenster einrichten

• Chart überwachen – JSONL von deinem lokal laufenden Chart für lokale Überwachungsskripte streamen

• CLI-Zugriff – Jedes MCP-Tool ist auch ein tv-CLI-Befehl, pipe-fähig mit JSON-Ausgabe

• TradingView starten – Automatische Erkennung und Start im Debug-Modus von jeder Plattform

Installation mit Claude Code

Füge dies in Claude Code ein und es erledigt den Rest:

Installiere den TradingView-MCP-Server. Klone https://github.com/tradesdontlie/tradingview-mcp.git, führe npm install aus, füge ihn zu meiner MCP-Konfiguration unter ~/.claude/.mcp.json hinzu und starte TradingView mit dem Debug-Port. Verifiziere dann die Verbindung mit tv_health_check.

Oder folge den manuellen Schritten unten.

Schnellstart

1. Installieren

git clone https://github.com/tradesdontlie/tradingview-mcp.git
cd tradingview-mcp
npm install

2. TradingView mit CDP starten

TradingView Desktop muss mit aktiviertem Chrome DevTools Protocol auf Port 9222 laufen.

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Oder manuell auf jeder Plattform starten:

/path/to/TradingView --remote-debugging-port=9222

Oder das MCP-Tool verwenden (erkennt deine Installation automatisch):

"Verwende tv_launch, um TradingView im Debug-Modus zu starten"

3. Zu Claude Code hinzufügen

Füge zu deiner Claude-Code-MCP-Konfiguration hinzu (~/.claude/.mcp.json oder Projekt-.mcp.json):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/path/to/tradingview-mcp/src/server.js"]
    }
  }
}

Ersetze /path/to/tradingview-mcp durch deinen tatsächlichen Pfad.

4. Verifizieren

Frage Claude: "Verwende tv_health_check, um zu verifizieren, dass TradingView verbunden ist"

CLI

Jedes MCP-Tool ist auch als tv-CLI-Befehl verfügbar. Die gesamte Ausgabe ist JSON für die Verwendung mit jq.

# Install globally (optional)
npm link

# Or run directly
node src/cli/index.js <command>

Kurzbeispiele

tv status                          # check connection
tv quote                           # current price
tv symbol AAPL                     # change symbol
tv ohlcv --summary                 # price summary
tv screenshot -r chart             # capture chart
tv pine compile                    # compile Pine Script
tv pane layout 2x2                 # 4-chart grid
tv pane symbol 1 ES1!              # set pane symbol
tv stream quote | jq '.close'      # monitor price changes

Alle Befehle

tv status / launch / state / symbol / timeframe / type / info / search
tv quote / ohlcv / values
tv data lines/labels/tables/boxes/strategy/trades/equity/depth/indicator
tv pine get/set/compile/analyze/check/save/new/open/list/errors/console
tv draw shape/list/get/remove/clear
tv alert list/create/delete
tv watchlist get/add
tv indicator add/remove/toggle/set/get
tv layout list/switch
tv pane list/layout/focus/symbol
tv tab list/new/close/switch
tv replay start/step/stop/status/autoplay/trade
tv stream quote/bars/values/lines/labels/tables/all
tv ui click/keyboard/hover/scroll/find/eval/type/panel/fullscreen/mouse
tv screenshot / discover / ui-state / range / scroll

Streaming

Die tv stream-Befehle pollen deine lokal laufende TradingView-Desktop-Instanz in regelmäßigen Abständen über das Chrome DevTools Protocol auf localhost.

Es wird keine Verbindung zu den Servern von TradingView hergestellt. Alle Daten bleiben auf deinem Rechner.

[!WARNING] Die programmatische Nutzung von TradingView-Daten kann unabhängig von der Datenquelle mit den Nutzungsbedingungen kollidieren. Du bist allein dafür verantwortlich, dass deine Nutzung konform ist.

tv stream quote                          # price tick monitoring
tv stream bars                           # bar-by-bar updates
tv stream values                         # indicator value monitoring
tv stream lines --filter "NY Levels"     # price level monitoring
tv stream tables --filter Profiler       # table data monitoring
tv stream all                            # all panes at once (multi-symbol)

Wie Claude weiß, welches Tool es verwenden soll

Claude liest CLAUDE.md automatisch, wenn es in diesem Projekt arbeitet. Es enthält einen vollständigen Entscheidungsbaum:

Tool-Referenz (78 MCP-Tools)

Chart lesen

Benutzerdefinierte Indikatordaten (Pine-Zeichnungen)

Lies line.new()-, label.new()-, table.new()-, box.new()-Ausgaben von jedem sichtbaren Pine-Indikator.

Immer study_filter verwenden, um einen bestimmten Indikator anzusprechen: study_filter: "Profiler".

Chart-Steuerung

Mehrfenster-Layouts

Tab-Verwaltung

Pine-Script-Entwicklung

Replay-Modus

Zeichnungen, Alarme, UI-Automatisierung

Kontextverwaltung

Tools geben standardmäßig kompakte Ausgaben zurück, um den Kontextverbrauch zu minimieren. Für einen typischen Workflow „Meinen Chart analysieren“ beträgt der Gesamtkontext ~5-10KB statt ~80KB.

TradingView auf Ihrem System finden

Startskripte und tv_launch erkennen TradingView automatisch. Wenn die automatische Erkennung fehlschlägt:

Das entscheidende Flag: --remote-debugging-port=9222

Tests

# Requires TradingView running with --remote-debugging-port=9222
npm test

29 Tests, die Folgendes abdecken: Pine-Script-Statikanalyse, serverseitige Kompilierung und CLI-Routing.

Architektur

Claude Code  ←→  MCP Server (stdio)  ←→  CDP (port 9222)  ←→  TradingView Desktop (Electron)

• Transport: MCP über stdio (84 Tools) + CLI (tv-Befehl, 30 Befehle mit 66 Unterbefehlen)

• Verbindung: Chrome DevTools Protocol auf localhost:9222

• Streaming: Poll-and-Diff-Schleife mit Deduplizierung, JSONL-Ausgabe auf stdout

• Keine Abhängigkeiten außer @modelcontextprotocol/sdk und chrome-remote-interface

Namensnennungen

Dieses Projekt ist nicht mit den folgenden Unternehmen verbunden, von ihnen unterstützt oder assoziiert:

• TradingView Inc. – TradingView ist eine Marke von TradingView Inc.

• Anthropic – Claude und Claude Code sind Marken von Anthropic, PBC.

Dieses Tool ist ein unabhängiger MCP-Server, der über das standardmäßige MCP-Protokoll eine Verbindung zu Claude Code herstellt. Es enthält keine Anthropic-Software und modifiziert sie auch nicht.

Haftungsausschluss

Dieses Projekt wird nur für persönliche, bildungsbezogene und Forschungszwecke bereitgestellt.

So funktioniert dieses Tool: Dieses Tool verwendet das Chrome DevTools Protocol (CDP), die standardmäßige Debugging-Schnittstelle, die in Chromium-basierten Anwendungen integriert ist. Es führt kein Reverse Engineering eines proprietären TradingView-Protokolls durch, verbindet sich nicht mit den Servern von TradingView und umgeht keine Zugriffskontrollen. Der Debug-Port muss vom Benutzer explizit über ein standardmäßiges Chromium-Befehlszeilenflag (--remote-debugging-port=9222) aktiviert werden.

Durch die Nutzung dieser Software erkennen Sie an und stimmen zu, dass:

1. Sie sind allein verantwortlich dafür, dass Ihre Nutzung dieses Tools den Nutzungsbedingungen von TradingView und allen geltenden Gesetzen entspricht.

2. Die Nutzungsbedingungen von TradingView schränken automatisierte Datenerfassung, Scraping und nicht-displaybezogene Nutzung ihrer Plattform und Daten ein. Dieses Tool verwendet das Chrome DevTools Protocol, um programmatisch mit der TradingView-Desktop-App zu interagieren, was mit diesen Bedingungen in Konflikt geraten kann.

3. Sie übernehmen das gesamte Risiko, das mit der Nutzung dieses Tools verbunden ist. Die Autoren sind nicht verantwortlich für Kontosperrungen, Suspendierungen, rechtliche Schritte oder andere Konsequenzen, die sich aus der Nutzung ergeben.

4. Dieses Tool darf nicht verwendet werden für, einschließlich, aber nicht beschränkt auf:

   • Weiterverbreitung, Weiterverkauf oder kommerzielle Nutzung der Marktdaten von TradingView

   • Umgehung der Zugriffskontrollen oder Abonnementbeschränkungen von TradingView

   • Durchführung von automatisiertem Handel oder algorithmischen Entscheidungen unter Verwendung extrahierter Daten

   • Verletzung der geistigen Eigentumsrechte der Autoren von Pine-Script-Indikatoren

   • Verbindung zu den Servern oder der Infrastruktur von TradingView (der gesamte Zugriff erfolgt über die lokal ausgeführte Desktop-App)

5. Die Streaming-Funktionalität überwacht nur Ihre lokal ausgeführte TradingView-Desktop-Instanz. Sie verbindet sich nicht mit den Servern von TradingView und extrahiert keine Daten aus der Infrastruktur von TradingView.

6. Marktdaten, auf die über dieses Tool zugegriffen wird, unterliegen weiterhin den Lizenzbedingungen der Börsen und Datenanbieter. Verteilen, speichern oder nutzen Sie keine Daten, die über dieses Tool erhalten wurden, kommerziell weiter.

7. Dieses Tool greift auf interne, undokumentierte Schnittstellen der TradingView-Anwendung zu, die sich jederzeit ohne Vorankündigung ändern oder ausfallen können.

Nutzung auf eigene Gefahr. Wenn Sie sich nicht sicher sind, ob Ihre beabsichtigte Nutzung den Bedingungen von TradingView entspricht, verwenden Sie dieses Tool nicht.

Lizenz

MIT – siehe LICENSE für Details.

Die MIT-Lizenz gilt nur für den Quellcode dieses Projekts. Sie gewährt keine Rechte an der Software, den Daten, Marken oder dem geistigen Eigentum von TradingView.