# swarnadeep-dey/tradingview-claude-mcp-setup architecture

> Architecture diagram of the GitHub repository swarnadeep-dey/tradingview-claude-mcp-setup, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swarnadeep-dey/tradingview-claude-mcp-setup
- Repository: https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup

## Overview

This repository exposes TradingView chart automation and analysis to Claude through MCP, with a parallel command-line interface. The main workflow is Claude tool request → registered tool adapter → domain core operation → Chrome DevTools Protocol connection to the live TradingView chart, returning chart data or an action result. Domain capabilities include chart and market data, Pine Script, indicators, drawings, alerts, replay, watchlists, UI, panes, tabs, capture, health, streaming, and batch operations. Core modules use the shared connection layer; some unsampled capabilities are shown without inferred call edges.

Main entry points: [`src/tools`](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/tools) (Tool Adapters), [`src/connection.js`](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/connection.js) (CDP Connection), [`src/server.js`](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/server.js) (MCP Server), [`src/cli/commands`](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/cli/commands) (CLI Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_mcp["MCP Server<br/>[server.js]"]
  node_tool_adapters["Tool Adapters"]
  node_cli["CLI Commands"]
  node_router["CLI Router<br/>[router.js]"]
end

subgraph group_domain["TradingView Capabilities"]
  node_chart["Chart Control<br/>[chart.js]"]
  node_market_data["Market Data<br/>[data.js]"]
  node_pine["Pine Scripts<br/>[pine.js]"]
  node_indicators["Indicators<br/>[indicators.js]"]
  node_drawings["Chart Drawings<br/>[drawing.js]"]
  node_alerts["Alerts<br/>[alerts.js]"]
  node_replay["Replay<br/>[replay.js]"]
  node_watchlist["Watchlists<br/>[watchlist.js]"]
  node_ui["UI Automation<br/>[ui.js]"]
  node_panes["Chart Panes<br/>[pane.js]"]
  node_tabs["Chart Tabs<br/>[tab.js]"]
  node_capture["Capture<br/>[capture.js]"]
  node_health["Health Checks<br/>[health.js]"]
  node_stream["Live Stream<br/>[stream.js]"]
  node_batch["Batch Operations<br/>[batch.js]"]
end

subgraph group_runtime["Browser Runtime"]
  node_connection["CDP Connection<br/>[connection.js]"]
end

node_claude(("Claude Desktop"))
node_chrome["Chrome CDP"]
node_tradingview["TradingView Chart"]

node_claude -->|"sends requests"| node_mcp
node_mcp -->|"registers tools"| node_tool_adapters
node_cli -->|"registers commands"| node_router
node_router -->|"dispatches handlers"| node_cli
node_tool_adapters -->|"calls"| node_chart
node_tool_adapters -->|"calls"| node_market_data
node_tool_adapters -->|"calls"| node_pine
node_tool_adapters -->|"calls"| node_indicators
node_tool_adapters -->|"calls"| node_drawings
node_tool_adapters -->|"calls"| node_alerts
node_tool_adapters -->|"calls"| node_replay
node_tool_adapters -->|"calls"| node_watchlist
node_tool_adapters -->|"calls"| node_ui
node_tool_adapters -->|"calls"| node_panes
node_tool_adapters -->|"calls"| node_tabs
node_tool_adapters -->|"registers tools"| node_capture
node_tool_adapters -->|"registers tools"| node_health
node_tool_adapters -->|"registers tools"| node_batch
node_chart -->|"evaluates chart"| node_connection
node_market_data -->|"evaluates data"| node_connection
node_pine -->|"evaluates scripts"| node_connection
node_drawings -->|"evaluates chart"| node_connection
node_alerts -->|"uses connection"| node_connection
node_replay -->|"uses connection"| node_connection
node_watchlist -->|"uses connection"| node_connection
node_ui -->|"evaluates UI"| node_connection
node_health -->|"checks connection"| node_connection
node_stream -->|"uses connection"| node_connection
node_connection -->|"connects via CDP"| node_chrome
node_chrome -->|"controls chart"| node_tradingview

click node_mcp "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/server.js"
click node_tool_adapters "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/tools"
click node_cli "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/cli/commands"
click node_router "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/cli/router.js"
click node_chart "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/chart.js"
click node_market_data "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/data.js"
click node_pine "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/pine.js"
click node_indicators "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/indicators.js"
click node_drawings "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/drawing.js"
click node_alerts "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/alerts.js"
click node_replay "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/replay.js"
click node_watchlist "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/watchlist.js"
click node_ui "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/ui.js"
click node_panes "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/pane.js"
click node_tabs "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/tab.js"
click node_capture "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/capture.js"
click node_health "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/health.js"
click node_stream "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/stream.js"
click node_batch "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/batch.js"
click node_connection "https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/connection.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_tool_adapters,node_cli,node_router,node_tradingview toneBlue
class node_chart,node_market_data,node_pine,node_indicators,node_drawings,node_alerts,node_replay,node_watchlist,node_ui,node_panes,node_tabs,node_capture,node_health,node_stream,node_batch toneAmber
class node_connection toneMint
class node_claude,node_chrome toneIndigo
```

## Components

### User Interfaces

- [MCP Server](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/server.js): `src/server.js`
- [Tool Adapters](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/tools): `src/tools`
- [CLI Commands](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/tree/main/src/cli/commands): `src/cli/commands`
- [CLI Router](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/cli/router.js): `src/cli/router.js`

### TradingView Capabilities

- [Chart Control](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/chart.js): `src/core/chart.js`
- [Market Data](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/data.js): `src/core/data.js`
- [Pine Scripts](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/pine.js): `src/core/pine.js`
- [Indicators](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/indicators.js): `src/core/indicators.js`
- [Chart Drawings](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/drawing.js): `src/core/drawing.js`
- [Alerts](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/alerts.js): `src/core/alerts.js`
- [Replay](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/replay.js): `src/core/replay.js`
- [Watchlists](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/watchlist.js): `src/core/watchlist.js`
- [UI Automation](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/ui.js): `src/core/ui.js`
- [Chart Panes](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/pane.js): `src/core/pane.js`
- [Chart Tabs](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/tab.js): `src/core/tab.js`
- [Capture](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/capture.js): `src/core/capture.js`
- [Health Checks](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/health.js): `src/core/health.js`
- [Live Stream](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/stream.js): `src/core/stream.js`
- [Batch Operations](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/core/batch.js): `src/core/batch.js`

### Browser Runtime

- [CDP Connection](https://github.com/swarnadeep-dey/tradingview-claude-mcp-setup/blob/main/src/connection.js): `src/connection.js`

### Other components

- **Claude Desktop**
- **Chrome CDP**
- **TradingView Chart**

## Connections

- Claude Desktop → MCP Server: sends requests (evidence: `README.md`)
- MCP Server → Tool Adapters: registers tools (evidence: `src/server.js`)
- CLI Commands → CLI Router: registers commands (evidence: `src/cli/index.js`)
- CLI Router → CLI Commands: dispatches handlers (evidence: `src/cli/router.js`)
- Tool Adapters → Chart Control: calls (evidence: `src/tools/chart.js`)
- Tool Adapters → Market Data: calls (evidence: `src/tools/data.js`)
- Tool Adapters → Pine Scripts: calls (evidence: `src/tools/pine.js`)
- Tool Adapters → Indicators: calls (evidence: `src/tools/indicators.js`)
- Tool Adapters → Chart Drawings: calls (evidence: `src/tools/drawing.js`)
- Tool Adapters → Alerts: calls (evidence: `src/tools/alerts.js`)
- Tool Adapters → Replay: calls (evidence: `src/tools/replay.js`)
- Tool Adapters → Watchlists: calls (evidence: `src/tools/watchlist.js`)
- Tool Adapters → UI Automation: calls (evidence: `src/tools/ui.js`)
- Tool Adapters → Chart Panes: calls (evidence: `src/tools/pane.js`)
- Tool Adapters → Chart Tabs: calls (evidence: `src/tools/tab.js`)
- Tool Adapters → Capture: registers tools
- Tool Adapters → Health Checks: registers tools
- Tool Adapters → Batch Operations: registers tools
- Chart Control → CDP Connection: evaluates chart (evidence: `src/core/chart.js`)
- Market Data → CDP Connection: evaluates data (evidence: `src/core/data.js`)
- Pine Scripts → CDP Connection: evaluates scripts (evidence: `src/core/pine.js`)
- Chart Drawings → CDP Connection: evaluates chart (evidence: `src/core/drawing.js`)
- Alerts → CDP Connection: uses connection (evidence: `src/core/alerts.js`)
- Replay → CDP Connection: uses connection (evidence: `src/core/replay.js`)
- Watchlists → CDP Connection: uses connection (evidence: `src/core/watchlist.js`)
- UI Automation → CDP Connection: evaluates UI (evidence: `src/core/ui.js`)
- Health Checks → CDP Connection: checks connection (evidence: `src/core/health.js`)
- Live Stream → CDP Connection: uses connection (evidence: `src/core/stream.js`)
- CDP Connection → Chrome CDP: connects via CDP (evidence: `src/connection.js`)
- Chrome CDP → TradingView Chart: controls chart (evidence: `README.md`)
