TradingView MCP Bridge

TradingView Desktop のチャートのためのパーソナル AI アシスタントです。Claude Code をローカルで実行中の TradingView アプリに Chrome DevTools Protocol を介して接続し、AI 支援によるチャート分析、Pine Script 開発、ワークフロー自動化を実現します。

[!WARNING] 本ツールは、TradingView Inc. とは提携、推奨、または関連するものではありません。 本ツールは、Chrome DevTools Protocol を介して、ローカルで実行中の TradingView Desktop アプリと連携します。使用前に免責事項をご確認ください。

[!IMPORTANT] 有効な TradingView サブスクリプションが必要です。 本ツールは、TradingView のペイウォールやアクセス制御を回避・迂回するものではありません。すでにマシン上で実行されている TradingView Desktop アプリの読み取りと操作を行います。

[!NOTE] すべてのデータ処理は、お使いのマシン上でローカルに実行されます。 本ツールによって、TradingView のデータが外部に送信、保存、再配布されることはありません。

[!CAUTION] このツールは、Electron デバッグインターフェースを介して、文書化されていない TradingView の内部 API にアクセスします。これらは、TradingView のアップデートにより予告なく変更または破損する可能性があります。安定性が重要な場合は、TradingView Desktop のバージョンを固定してください。

仕組み（そして、安全に実行できる理由）

このツールは、TradingView のサーバーに接続したり、TradingView のファイルを変更したり、ネットワークトラフィックを傍受したりすることはありません。通信対象は、ローカルで実行中の TradingView Desktop インスタンスのみで、Chrome DevTools Protocol (CDP) を介して行われます。これは、VS Code、Slack、Discord など、すべての Chromium/Electron アプリケーションに Google が組み込んだ標準のデバッグインターフェースです。

デバッグポートはデフォルトで無効になっており、標準の Chromium フラグ（--remote-debugging-port=9222）を使用して、ユーザー自身が明示的に有効にする必要があります。この意図的な手順を踏まない限り、何も起こりません。

Related MCP server: TradingView MCP Bridge

このツールが行わないこと

• TradingView のサーバーや API に接続すること

• マーケットデータを保存、送信、再配布すること

• 有効な TradingView サブスクリプションと、インストール済みの Desktop アプリなしで動作すること

• TradingView のペイウォールやアクセス制限を回避すること

• 実際の取引を実行すること（チャート操作のみ）

• TradingView が内部の Electron 構造を変更した場合に動作すること

研究の背景

このプロジェクトは、オープンな研究課題を探求しています。LLM ベースのエージェントは、人間の意思決定を支援するために、プロフェッショナルな取引インターフェースとどのように対話できるのか？

具体的には、以下を調査します。

• 構造化ツール API (MCP) が LLM とステートフルなデスクトップ金融アプリケーションをどのように橋渡しできるか

• エージェントがライブチャートデータ上で動作する際に発生する遅延、コンテキスト、信頼性の制約とは何か

• エージェントが曖昧な金融 UI 状態（Pine Script 出力の解釈、インジケーターテーブルの読み取りなど）をどのように処理するか

• チャートナビゲーションや Pine Script 開発において、自然言語が効果的なインターフェースであるかどうか

• リアルタイムデータ環境で動作する LLM エージェントの障害モード

これは取引ボットではありません。取引アプリケーションを LLM エージェントが読み取れるようにするインターフェース層であり、研究者や開発者が金融ワークフローにおける人間と AI の協働を研究できるようにします。

未解決の質問、調査結果、関連研究については、RESEARCH.md を参照してください。

前提条件

• TradingView Desktop アプリ（リアルタイムデータには有料サブスクリプションが必要）

• Node.js 18+

• Claude Code（MCP ツール用）または任意のターミナル（CLI 用）

• macOS、Windows、Linux

できること

あなたの AI アシスタントに、自分のチャートへの「目」と「手」を与えます。

• Pine Script 開発 — AI 支援でスクリプトの作成、注入、コンパイル、デバッグ、反復が可能

• チャート操作 —シンボル、時間枠の変更、日付へのズーム、インジケーターの追加・削除

• ビジュアル分析 — チャートのインジケーター値、価格レベル、注釈の読み取り

• チャートへの描画 — トレンドライン、水平ライン、四角形、テキスト注釈

• アラート管理 — 価格アラートの作成、一覧表示、削除

• リプレイ練習 — 過去バーをステップ実行し、エントリー・エグジットを練習

• スクリーンショット — AI のビジュアル分析のためにチャートをキャプチャ

• マルチペインレイアウト — ペインごとに異なるシンボルで 2x2、3x1 などのグリッドを設定

• チャートのモニタリング — ローカルで実行中のチャートから JSONL をストリームし、ローカル監視スクリプトで利用

• CLI アクセス — すべての MCP ツールは tv CLI コマンドとしても利用可能。JSON 出力でパイプに最適

• TradingView の起動 — デバッグモードを自動検出し、任意のプラットフォームで起動

Claude Code でインストール

これを Claude Code に貼り付けると、残りは Claude Code が処理します：

TradingView の MCP サーバーをインストールしてください。https://github.com/tradesdontlie/tradingview-mcp.git をクローンし、npm install を実行し、~/.claude/.mcp.json にある私の MCP 設定に追加し、デバッグポート付きで TradingView を起動してください。その後、tv_health_check で接続を確認してください。

または、以下の手動手順に従います。

クイックスタート

1. インストール

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

2. CDP を使用して TradingView を起動

TradingView Desktop は、ポート 9222 で Chrome DevTools Protocol を有効にして実行する必要があります。

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

または、任意のプラットフォームで手動起動：

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

または MCP ツールを使用（インストール先を自動検出）：

"Use tv_launch to start TradingView in debug mode"

3. Claude Code に追加

Claude Code の MCP 設定（~/.claude/.mcp.json またはプロジェクトの .mcp.json）に追加します：

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

/path/to/tradingview-mcp を実際のパスに置き換えます。

4. 確認

Claude にこう依頼します："Use tv_health_check to verify TradingView is connected"

CLI

すべての MCP ツールは、tv CLI コマンドとしても利用できます。すべての出力は JSON 形式で、jq でのパイプ処理に対応しています。

# Install globally (optional)
npm link

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

クイック例

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

すべてのコマンド

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

ストリーミング

tv stream コマンドは、localhost 上の Chrome DevTools Protocol を介して、ローカルで実行中の TradingView Desktop インスタンスを定期的にポーリングします。

TradingView のサーバーには接続されません。すべてのデータはお使いのマシンに留まります。

[!WARNING] データソースに関係なく、TradingView のデータをプログラムから消費することは、同社の利用規約と矛盾する可能性があります。ご自身の利用が規約に適合していることを確認する責任は、すべてあなたにあります。

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)

Claude がどのツールを使うか

Claude は、このプロジェクトで作業するときに、CLAUDE.md を自動的に読み取ります。この中には、完全な判断ツリーが含まれています：

ツールリファレンス（78 の MCP ツール）

チャートの読み取り

カスタムインジケーターデータ（Pine 描画）

表示されているすべての Pine インジケーターから、line.new()、label.new()、table.new()、box.new() の出力を読み取ります。

特定のインジケーターを対象にするには、常に study_filter を使用してください： study_filter: "Profiler"。

チャートコントロール

マルチペインレイアウト

タブ管理

Pine Script 開発

リプレイモード

描画、アラート、UI自動化

コンテキスト管理

ツールはデフォルトでコンパクトな出力を返し、コンテキスト使用量を最小限に抑えます。一般的な「チャートを分析」ワークフローでは、総コンテキストは約~80KBではなく~5-10KBになります。

システム上のTradingViewを検索

起動スクリプトとtv_launchはTradingViewを自動検出します。自動検出が失敗した場合:

重要なフラグ: --remote-debugging-port=9222

テスト

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

Pine Script静的解析、サーバーサイドコンパイル、CLIルーティングをカバーする29件のテスト。

アーキテクチャ

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

• トランスポート: stdio上のMCP (84ツール) + CLI (tvコマンド、30コマンド、66サブコマンド)

• 接続: localhost:9222上のChrome DevTools Protocol

• ストリーミング: 重複排除付きのポーリング・アンド・ディフループ、stdoutへのJSONL出力

• 依存関係なし @modelcontextprotocol/sdkとchrome-remote-interface以外

帰属

このプロジェクトは、以下とは提携、承認、または関連していません:

• TradingView Inc. — TradingViewはTradingView Inc.の商標です。

• Anthropic — ClaudeとClaude CodeはAnthropic, PBCの商標です。

このツールは、標準のMCPプロトコルを介してClaude Codeに接続する独立したMCPサーバーです。Anthropicのソフトウェアを含んだり、変更したりすることはありません。

免責事項

このプロジェクトは個人、教育、研究目的のみに提供されています。

このツールの仕組み: このツールは、Chromiumベースのアプリケーションに組み込まれている標準のデバッグインターフェースであるChrome DevTools Protocol (CDP)を使用します。TradingViewの独自プロトコルをリバースエンジニアリングしたり、TradingViewのサーバーに接続したり、アクセス制御を回避したりすることはありません。デバッグポートは、標準のChromiumコマンドラインフラグ(--remote-debugging-port=9222)を介してユーザーが明示的に有効にする必要があります。

このソフトウェアを使用することで、あなたは以下を理解し同意したことになります:

1. あなたは単独で責任を負います このツールの使用がTradingViewの利用規約およびすべての適用される法律に準拠していることを確認する責任はあなたにあります。

2. TradingViewの利用規約は、プラットフォームとデータの自動データ収集、スクレイピング、非表示用途を制限しています。このツールはChrome DevTools Protocolを使用してTradingViewデスクトップアプリとプログラム的に操作しますが、これはそれらの規約と矛盾する可能性があります。

3. あなたはすべてのリスクを負担します このツールの使用に伴うリスクはすべてあなたが負担します。著者は、その使用に起因するアカウントの停止、サスペンション、法的措置、その他の結果について責任を負いません。

4. このツールは、以下を含むがこれらに限定されない使用をしてはなりません:

   • TradingViewの市場データの再配布、再販売、または商業的利用

   • TradingViewのアクセス制御やサブスクリプション制限の回避

   • 抽出したデータを使用した自動取引やアルゴリズムによる意思決定

   • Pine Scriptインジケーター作成者の知的財産権の侵害

   • TradingViewのサーバーやインフラへの接続 (すべてのアクセスはローカルで実行されているデスクトップアプリを介して行われます)

5. ストリーミング機能は、ローカルで実行されているTradingViewデスクトップインスタンスのみを監視します。TradingViewのサーバーに接続したり、TradingViewのインフラからデータを抽出したりすることはありません。

6. このツールを通じてアクセスされる市場データは、取引所とデータプロバイダーのライセンス条件の対象です。このツールを通じて取得したデータを再配布、保存、または商業的に利用しないでください。

7. このツールは、TradingViewの内部の文書化されていないアプリケーションインターフェースにアクセスします。これらは予告なくいつでも変更または壊れる可能性があります。

自己責任で使用してください。 意図した使用がTradingViewの利用規約に適合しているか不明な場合は、このツールを使用しないでください。

ライセンス

MIT — 詳細はLICENSEを参照してください。

MITライセンスはこのプロジェクトのソースコードにのみ適用されます。TradingViewのソフトウェア、データ、商標、知的財産に対する権利を付与するものではありません。