TradingView MCP

お使いのマシン上で動作する TradingView Desktop 向けの Model Context Protocol (MCP) サーバーです。Chrome DevTools Protocol (localhost:9222) を介して、チャートの読み取り、毎日のモーニングブリーフの実行、Pine Script の開発、ワークフローの自動化が行えます。

メンテナー: John Anthony。 このプロジェクトは、@tradesdontlie による上流の tradingview-mcp に、モーニングブリーフのワークフロー、ルール設定 (rules.json)、および TradingView Desktop v2.14+ における tv_launch の修正を加えたものです。

[!WARNING] TradingView Inc. や Anthropic とは無関係です。 このツールは、ローカルで実行中の TradingView Desktop アプリに Chrome DevTools Protocol 経由でエンドポイント接続します。使用する前に免責事項をお読みください。

[!IMPORTANT] 有効な TradingView サブスクションが必要です。 このツールは TradingView のペイウォールを回避するものではありません。お使いのマシン上で既に実行されている TradingView Desktop アプリからの読み取りとー制御にのみ使用します。

[!NOTE] すべてのデータ処理はローカルで行われます。 どこかに送信されることはありません。TradingView のデータがお使いのマシンの外に出ることはありません。

このフォークの新機能

| 機能 | 詳細 | | morning_brief | ウォッチリストをスキャンし、すべてのインジケーターを読み取って、Claude がセッションバイアスを生成するための構造化データを返す単一コマンド | | session_save / session_get | 毎日のブリーフを ~/.tradingview-mcp/sessions/ に保存し、今日と昨日の比較を可能にする | | rules.json | 取引ルールを一度だけ記述するだけで OK。バイアス基準、リスクルール、ウォッチリストを定義し、モーニングブリーフが毎日自動的に適用。 | | 起動バグの修正 | tv_launch の TradingView Desktop v2.14+ との互換性を修正 | | tv brief CLI | ターミナルで一語の入力でモーニングブリーフを実行 |

Related MCP server: TradingView MCP Bridge

にシームレスなセットアップ

これを Claude Code に貼り付ければ、すべてを自動処理します:

Set up TradingView MCP for me. 
Clone https://github.com/anthonyjohn17/tradingview-mcp.git to ~/tradingview-mcp, run npm install, then add it to my MCP config at ~/.claude/.mcp.json (merge with any existing servers, don't overwrite them). 
The config block is: { "mcpServers": { "tradingview": { "command": "node", "args": ["/Users/YOUR_USERNAME/tradingview-mcp/src/server.js"] } } } — replace YOUR_USERNAME with my actual username.
Then copy rules.example.json to rules.json and open it so I can fill in my trading rules.
Finally restart and verify with tv_health_check.

または、以下ので手動です手順に従ってください。

前提条件

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

• Node.js 18+

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

• macOS、Windows、Linux

クイックスタート

1. クローンしてインストール

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

2. ルールを設定する

cp rules.example.json rules.json

rules.json を開いて、次の項目を記入してください:

• ウォッチリスト (毎朝スキャンするシンボル)

• バイアス基準 (あなたにとって何が強気/弱気/中立なのかの基準)

• リスクルール (セッション前に Claude に毎回チェックしてほしいルール)

3. CDP (Chrome DevTools Protocol) で TradingView を起動

TradingView はデバッグポートを有効にして起動する必要があります。

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

または、セットアップ後に MCP ツールを使う: 「tv_launch を使用して TradingView をデバッグモードで起動して」

4. Claude Code に追加

~/.claude/.mcp.json に追加します (既存のサーバー設定とマージ):

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

YOUR_USERNAME は実際のユーザー名に置き換えてください。Mac では echo $USER で確認できます。

SSE トランスポート (代替方法)

stdio の代わりに HTTP/SSE で MCP サーバーを実行:

SSE サーバーを起動:

# Mac/Linux
TRANSPORT=sse PORT=3000 node src/server.js

# Windows
set TRANSPORT=sse
node src/server.js

起動スクリプト: 起動スクリプト:

# Mac/Linux - custom port
./scripts/launch_mcp_sse.sh 8080

# Windows - custom port
scripts\launch_mcp_sse.bat 8080

**Claude Code が SSE に接続するよう設定:**Claude Code が SSE に接続するように設定する：

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

SSE サーバーはデフォルトで http://127.0.0.1:3000/metrics で待ち受ます。ポートは PORT 環境変数で変更できます。

5. 動作確認

Claude Code を再起動し、次のように尋ねてください: tv\_health\_check を使用して TradingView の接続を確認して

6. 最初のモーニングブリーフを実行

Claude に依頼: 「morning_brief を実行して、セッションバイアス教えて」

または、ターミナルから:

npm link  # install tv CLI globally (one time)
tv brief

モーニングブリーフのワークフロー

このツールを単なるツールキットから、毎日の習慣に変える機能です。

各セッションの前に:

1. TradingView を開いておく (デバッグポート付きで起動)

2. ターミナルで tv brief を実行する (または Claude に 「morning_brief を実行」 と依頼)

3. Claude がウォッチリストのすべてのシンボルをスキャンし、インジケーター値を読み取り、あなたの rules.json の基準を適用して、次の内容を表示します:

BTCUSD  | BIAS: Bearish  | KEY LEVEL: 94,200  | WATCH: RSI crossing 50 on 4H
ETHUSD  | BIAS: Neutral  | KEY LEVEL: 3,180   | WATCH: Ribbon direction on daily
SOLUSD  | BIAS: Bullish  | KEY LEVEL: 178.50  | WATCH: Hold above 20 EMA

Overall: Cautious session. BTC leading bearish, SOL the exception — watch for divergence.

4. 保存する: "このブリーフを保存して" (session_save を使用)

5. 翌朝、比較する: "昨日のセッションは取得して" (session_get を5. "昨日のセッション" を取得)

このツールができること

• モーニングブリーフ — ウォッチリストのスキャン、インジケーターの読み取り、ルールの適用、セッションバイアの表示

• Pine Script 開発 — AIでスクリプトの記述、注入、コンパイル、デバッグが可能

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

• 視覚的分析 — インジケーター値、価格レベル、カスタムインジケーターが描くレベルを読み取り

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

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

• リプレイ演習 — ヒストリカル足を順に送り、損益 (P&L) に加えながらエントリーと退出を練習

• スクリーンショット — チャートの状態をキャプチャ

• マルチペインレイアウト — 各ペインに異なるシンボルを持つ 2x2, 3x1 グリッド

• データ配信 — モニタリングスクリプト向けにライブチャートの JSONL 出力

• CLI 対応 — すべてのツールを tv コマンドとしても使用でき、パイプ可能な JSON 出力

Claude がどのツールを使うか

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

ツールリファレンス (81 MCP ツール)

モーニングブリーフ (本フォークでの新機能)

チャート読み取り

カスタムインジケーターデータ (Pine 描画)

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

必ず study_filter を使って特定のインジケーターを指定してください: study_filter: "MyIndicator"

チャート操作

Pine Script 開発

リプレイモード

| ツール | ステップ | | --- | | | replay_start | 指定日からリプレイ開始 | | replay_step | 1 バー進める | | replay_autoplay | メモ自動進行 (速度はmsで設定) | | replay_trade | 買い/売り/ポジションクローズ | | replay_status | ポジション、損益、日付を確認 | | replay_stop | リアルバーに戻る。バックフィル |

マルチパネル、アラート、描画、UI

CLI コマンド

tv brief                           # run morning brief
tv session get                     # get today's saved brief
tv session save --brief "..."      # save a brief

tv status                          # check connection
tv quote                           # current price
tv symbol BTCUSD                   # 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 stream quote | jq '.close'      # monitor price ticks

全コマンド一覧: tv --help

トラブルシューティング

アーキテクチャ

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

• 78 個のオリジナルツール + 3 個のモーニングブリーフツール = 合計 81 個の MCP ツール

• トランスポート: stdio 上の MCP（デフォルト）または SSE（TRANSPORT=sse）

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

• 外部ネットワーク呼び出しなし — すべてローカルで実行

• 追加依存関係ゼロ（オリジナル以外）

SSE トランスポート

stdio の代わりに HTTP/SSE でサーバーを実行します:

TRANSPORT=sse node src/server.js

サーバーはデフォルトで http://127.0.0.1:3000/sse をリッスンします。上書きするには:

TRANSPORT=sse PORT=8080 HOST=0.0.0.0 node src/server.js

SSE 経由で接続するように Claude Code を設定します:

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

クレジット

• アップストリーム: tradingview-mcp（@tradesdontlie 著）— オリジナルの MCP ブリッジおよび基盤。

• このフォーク: John Anthony — モーニングブリーフ、セッションヘルパー、rules.json、および最近の TradingView Desktop ビルド向けの起動修正。

アップストリームが役立つと思ったら、そのリポジトリ にスターを付けてください。

免責事項

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

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

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

1. お客様の使用が TradingView の利用規約 および適用されるすべての法律に準拠していることを確認する責任は、お客様のみにあります。

2. このツールは、いつでも変更される可能性のある、文書化されていない TradingView 内部 API にアクセスします。

3. このツールは、TradingView の市場データを再配布、転売、または商業的に利用するために使用してはなりません。

4. 著者は、アカウントの停止、凍結、その他の結果について一切責任を負いません。

自己責任で使用してください。

ライセンス

MIT — LICENSE を参照してください。ソースコードのみに適用され、TradingView のソフトウェア、データ、商標には適用されません。