tradingview-mcp

tradingview-mcp/  v0.1   ──────────────────────────────────────────────────

Ein fokussierter, typsicherer MCP-Server, mit dem Claude Code (oder jeder andere MCP-kompatible Client) eine lokal ausgeführte TradingView Desktop-Anwendung steuern kann — Chart-Status lesen, Symbole und Zeitrahmen ändern, OHLCV-Balken abrufen, Screenshots erstellen.

Funktionsweise

Kapselt den TradingView Desktop-Chart in eine kleine Menge klar definierter MCP-Tools. Die Tools sind durchgehend mit Zod-Schemas typisiert, werden an der Schnittstelle validiert und geben nützliche Fehlermeldungen aus, wenn etwas schiefgeht.

                  ┌───────────────┐
                  │ Claude Code   │
                  │ (or any MCP   │
                  │  client)      │
                  └───────┬───────┘
                          │ stdio (MCP)
                          ▼
                  ┌───────────────┐
                  │tradingview-mcp│
                  └───────┬───────┘
                          │ Chrome DevTools Protocol
                          ▼
                  ┌───────────────┐
                  │ TradingView   │
                  │ Desktop       │
                  │ (--remote-    │
                  │  debugging-   │
                  │  port=9222)   │
                  └───────────────┘

Warum eine weitere TradingView-Integration?

Es gibt bereits bestehende TradingView-Automatisierungsprojekte. Dieses hier ist bewusst schlank gehalten:

• 12 Tools, nicht 78. Jedes Tool ist dokumentiert, typisiert und getestet.

• Strenges TypeScript. Kein any, keine impliziten Rückgaben, noUncheckedIndexedAccess ist aktiviert.

• Eine Verantwortung pro Datei. Verbindung, Seite, Tools und Server sind separate Ebenen – bei Versionsänderungen muss nur eine Stelle angepasst werden.

• Typisierte Fehler. ConnectionError, ToolExecutionError, ChartStateError etc. mit hilfreichen Meldungen.

• tradingview-mcp doctor. Ein Diagnosebefehl, der Ihnen genau sagt, was mit Ihrem Setup nicht stimmt.

Verwenden Sie dies, wenn Sie eine kleine, vorhersehbare Oberfläche wünschen, die Sie an einem Nachmittag durchlesen können. Nutzen Sie die „Alles-inklusive“-Alternativen, wenn Sie jede TradingView-Funktion abgedeckt haben möchten.

Installation

Erfordert Node.js 20+.

npm install -g tradingview-mcp
# or, in a project:
npm install tradingview-mcp

Für die Entwicklung:

git clone https://github.com/harshil1502/tradingview-mcp.git
cd tradingview-mcp
npm install
npm run build

Einrichtung — drei Schritte

1. Beenden Sie alle laufenden TradingView Desktop-Instanzen

Andernfalls kann der Debug-Port nicht aktiviert werden.

2. Starten Sie TradingView Desktop mit aktiviertem Debug-Port

macOS:

open -a "TradingView" --args --remote-debugging-port=9222

Windows:

& "C:\Users\<you>\AppData\Local\Programs\TradingView\TradingView.exe" --remote-debugging-port=9222

Linux:

tradingview --remote-debugging-port=9222

3. Verbindung überprüfen

tradingview-mcp doctor

Wenn alles korrekt verbunden ist, sehen Sie etwa Folgendes:

tradingview-mcp · doctor
─────────────────────────────────────────────
[ok]  CDP endpoint reachable on localhost:9222
[ok]  TradingView page found (NASDAQ:AAPL · 1h)
[ok]  tvWidget detected — chart state readable
─────────────────────────────────────────────
ready.

Verwendung mit Claude Code

Fügen Sie dies zu Ihrer Claude Code MCP-Konfiguration hinzu (~/.claude/mcp.json oder Projekt .mcp.json):

{
  "mcpServers": {
    "tradingview": {
      "command": "tradingview-mcp",
      "env": {
        "TV_MCP_PORT": "9222"
      }
    }
  }
}

Starten Sie Claude Code neu. Die unten aufgeführten Tools stehen dann zur Verfügung.

Tools

Weitere Tools folgen – siehe docs/roadmap.md.

Beispiel-Sitzung

You:    What's the chart showing?
Claude: [calls chart_get_state]
        Showing NASDAQ:AAPL on 1h timeframe with EMA20, EMA50.
        Last price 187.42.

You:    Switch to BTCUSDT 4h and pull the last 200 bars.
Claude: [calls chart_set_symbol, chart_set_timeframe, chart_get_ohlcv]
        Done. Range: 187 days. Open at start: 62,440.
        Close at end: 67,830. +8.6%.

Konfiguration

Entwicklung

npm install
npm run build         # tsc to dist/
npm run dev           # tsc --watch
npm test              # vitest run
npm run test:coverage # with v8 coverage report
npm run typecheck     # tsc --noEmit

Die Codebasis besteht aus vier Ebenen:

src/
├── index.ts              entry — reads env, starts stdio server
├── server.ts             MCP server, tool registration, request handlers
├── errors.ts             typed error classes
├── types.ts              shared types + Zod schemas
├── connection/
│   ├── cdp.ts            CDP client wrapper (chrome-remote-interface)
│   └── tradingview.ts    TradingView-page interactions (all evaluated JS lives here)
└── tools/
    ├── index.ts          tool registry
    └── chart.ts          chart_* tools

Um ein Tool hinzuzufügen:

1. Erstellen Sie eine neue Datei unter src/tools/ (oder erweitern Sie eine bestehende).

2. Exportieren Sie <name>Input und <name>Output Zod-Schemas sowie die Handler-Funktion.

3. Fügen Sie den Eintrag zu TOOLS in src/tools/index.ts hinzu.

4. Fügen Sie einen Test unter tests/ hinzu.

Das ist alles – automatisch registriert, automatisch validiert, automatisch introspektierbar.

Versionskompatibilität

Wenn TradingView aktualisiert wird und Tools nicht mehr funktionieren, prüfen Sie zuerst connection/tradingview.ts – das ist die einzige Datei, die die interne API von TradingView kennt.

Haftungsausschluss

Diese Software wird „wie besehen“ ohne jegliche Gewährleistung bereitgestellt. Durch die Ausführung bestätigen Sie:

• Sie verwenden Ihre eigene bezahlte TradingView Desktop-Instanz mit Ihren eigenen Daten.

• Sie haben den Chrome DevTools-Debug-Port selbst aktiviert.

• Die interne API von TradingView ist nicht dokumentiert und kann sich ändern.

• Nichts in dieser Software garantiert die Korrektheit von Handelsentscheidungen, die von einem KI-Agenten darauf basierend getroffen werden. Verwenden Sie es auf einem Demokonto, bevor Sie echtes Kapital riskieren.

Lizenz

MIT © 2026 Harshil Patel

Danksagungen

Dies ist eine neue Implementierung – von Grund auf neu erstellt mit dem Ziel, klein, gut typisiert und leicht lesbar zu sein. Wenn Sie an ähnlichen Tools in diesem Bereich gearbeitet haben, danke, dass Sie den Weg geebnet haben.