tradingview-mcp
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.
[!IMPORTANT] Dieses Projekt ist nicht mit TradingView Inc. verbunden, wird von dieser nicht unterstützt und steht in keinerlei Beziehung zu ihr. Es handelt sich um eine Brücke für den persönlichen Gebrauch, die über das Chrome DevTools Protocol mit Ihrer lokal ausgeführten TradingView Desktop-Anwendung interagiert – dieselbe Standard-Debug-Schnittstelle, die auch in Slack, VS Code, Discord und jeder anderen Electron-App integriert ist.
[!IMPORTANT] Erfordert ein gültiges TradingView-Abonnement. Dieses Tool umgeht, scrapt oder umgeht keine TradingView-Paywalls oder Zugriffskontrollen. Alles geschieht auf Ihrem Rechner mit der TradingView Desktop-Instanz, bei der Sie sich bereits angemeldet und für die Sie bezahlt haben.
[!NOTE] Die gesamte Verarbeitung erfolgt lokal. Es werden keine TradingView-Daten durch dieses Tool übertragen, gespeichert oder weitergegeben. Ihre Charts, Ihre Daten, Ihr Rechner.
[!CAUTION] Die interne Seiten-API von TradingView ist nicht dokumentiert. Sie kann sich zwischen Desktop-Releases ändern. Fixieren Sie eine funktionierende TradingView Desktop-Version, wenn Sie Stabilität wünschen, und prüfen Sie den Hinweis zur Versionskompatibilität, bevor Sie ein Upgrade durchführen.
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) │
└───────────────┘Related MCP server: TradingView MCP Jackson
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,noUncheckedIndexedAccessist 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,ChartStateErroretc. 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-mcpFür die Entwicklung:
git clone https://github.com/harshil1502/tradingview-mcp.git
cd tradingview-mcp
npm install
npm run buildEinrichtung — 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=9222Windows:
& "C:\Users\<you>\AppData\Local\Programs\TradingView\TradingView.exe" --remote-debugging-port=9222Linux:
tradingview --remote-debugging-port=9222[!NOTE] Das Flag
--remote-debugging-portist ein Standard-Chromium-Debug-Flag. Es ist optional und standardmäßig deaktiviert. Es passiert nichts, ohne dass Sie es explizit übergeben.
3. Verbindung überprüfen
tradingview-mcp doctorWenn 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
Tool | Beschreibung |
| Aktuelles Symbol, Zeitrahmen, sichtbare Studien, letzter Preis lesen |
| Aktives Symbol ändern (z. B. |
| Auflösung ändern ( |
| Bis zu 5.000 der aktuellsten OHLCV-Balken vom aktiven Chart abrufen |
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
Umgebungsvariable | Standard | Beschreibung |
|
| CDP-Host |
|
| CDP-Debug-Port |
| (automatisch erkannt) | Explizite CDP-Ziel-ID – nur erforderlich, wenn Sie mehrere TradingView-Fenster geöffnet haben |
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 --noEmitDie 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_* toolsUm ein Tool hinzuzufügen:
Erstellen Sie eine neue Datei unter
src/tools/(oder erweitern Sie eine bestehende).Exportieren Sie
<name>Inputund<name>OutputZod-Schemas sowie die Handler-Funktion.Fügen Sie den Eintrag zu
TOOLSinsrc/tools/index.tshinzu.Fügen Sie einen Test unter
tests/hinzu.
Das ist alles – automatisch registriert, automatisch validiert, automatisch introspektierbar.
Versionskompatibilität
TradingView Desktop | tradingview-mcp | Status |
2026.x.x | 0.1.x | Getestet |
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.
Available Tools
11 toolschart_get_ohlcvB
Fetch recent OHLCV bars from the active chart.
Inputs: count.
chart_get_stateA
Read the current chart state: symbol, timeframe, visible studies, and last price.
Inputs: no named parameters.
chart_set_symbolB
Change the active chart symbol (e.g. "NASDAQ:AAPL").
Inputs: symbol (required).
chart_set_timeframeB
Change the active chart timeframe / resolution.
Inputs: timeframe (required).
pine_compileB
Trigger a Pine compile and return diagnostics (errors, warnings).
Inputs: no named parameters.
pine_get_sourceA
Read the current Pine Editor source code. Pine Editor must be open.
Inputs: no named parameters.
pine_saveA
Save the current Pine script (commits + reloads the indicator on the chart).
Inputs: no named parameters.
pine_set_sourceB
Replace the Pine Editor source code with new content.
Inputs: code (required).
quote_getA
Get a real-time quote snapshot for the active symbol (last price, day OHLC, volume).
Inputs: no named parameters.
screenshot_chartA
Capture the chart pane as a base64-encoded PNG.
Inputs: no named parameters.
screenshot_fullA
Capture the full TradingView viewport as a base64-encoded PNG.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose. The chart_* tools handle different aspects of chart interaction, pine_* tools manage Pine script editing and compilation, screenshot_* tools capture images, and quote_get fetches real-time quotes. No overlapping functionality.
Tool names follow a consistent pattern: <domain>_<verb>_<noun> (e.g., chart_get_ohlcv, pine_set_source, screenshot_chart). All use lowercase with underscores, and the verb-noun structure is uniform across domains.
With 11 tools, the server is well-scoped for a TradingView MCP. It covers chart manipulation, Pine scripting, quotes, and screenshots without being bloated or too sparse.
The tool set covers core workflows like symbol/timeframe changes, data retrieval, Pine script management, and screenshots. A minor gap is the lack of tools to add or remove studies (only visible studies are read), but this does not severely hinder typical use cases.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
> TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a strategy with walk-forward validation, scan for smart-money and volume signals, or get a one-prompt morning market brief. In clients that support MCP Apps, price charts and the Markets panel are drawn right in the chat. > 40+ tools covering crypto (real-time), stocks, ETFs, FX, futures and commodities across major global exchanges. > Hosted, nothing to install: Pro $9/month (2,500 tool calls) or Pro+ $29/month (10,000). Paid upfront with a 14-day money-back guarantee; your API key arrives right after checkout. > Built on the open-source tradingview-mcp core (MIT, ~5k GitHub stars): self-host it free, or use the hosted version with zero ops. > For research and education, not financial advice. Not affiliated with TradingView
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server that lets AI agents directly control and interact with the TradingView desktop app via 88 chart-control tools, enabling automated chart reading, Pine Script compilation, strategy optimization, and replay control.11344 npm61MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that connects to TradingView Desktop via Chrome DevTools Protocol, enabling chart control, Pine Script development, and a morning brief workflow with AI-driven analysis.-
- AlicenseAqualityDmaintenanceA Codex-first MCP server that bridges TradingView Desktop via Chrome DevTools Protocol, enabling launch, symbol/timeframe control, and health checks from Codex CLI.54MIT
- AlicenseNot gradedqualityAmaintenanceA local MCP server that connects TradingView Desktop to AI assistants via Chrome DevTools Protocol, enabling Pine Script development, multi-timeframe analysis, and Wyckoff scanning with a rules engine.44 npm1MIT