TradingView-MCP

TradingView デスクトップアプリを AI に見せて、チャート分析を手伝ってもらうためのツールです。

AI エージェント(Claude Code / Codex / Antigravity など)にこのサーバーを登録すると、AI が「あなたが今見ているチャート」をそのまま読めるようになります。ログイン済みのアカウント・保存したレイアウト・購入済みのカスタムインジケーターがそのまま使えます。

できること

AI にこんなお願いができるようになります:

• 「今のチャートを分析して」 → チャート画像+ローソク足+インジケーター値を組み合わせて分析

• 「このインジケーターのシグナルを読んで」 → SELL/BUY ラベルやサポレジラインの数値を取得

• 「日足と4時間足の両方で環境認識して」 → チャートを動かさずに複数時間足の指標を一括取得

• 「日本株で RSI が30以下の銘柄を探して」 → スクリーナーで市場を検索

• 「ウォッチリストの銘柄を全部チェックして」 → リストの全銘柄のクォートを取得

Related MCP server: TradingView MCP Bridge

仕組み(ざっくり)

TradingView のデスクトップアプリは中身がブラウザ(Electron)なので、デバッグ用の入り口を開けて起動すると、外部プログラムからチャートの中身を読み取れます。この MCP サーバーがその橋渡しをします。

AIエージェント ⇄ tradingview-mcp ⇄ TradingView デスクトップアプリ(あなたのチャート)
                                  ⇄ TradingView 公開API(クォート・スクリーナー)

必要なもの

• macOS + TradingView デスクトップアプリ(無料プランでOK)

• Node.js 20以上(node --version で確認)

• AI エージェントいずれか: Claude Code / Codex / Antigravity など

セットアップ(3ステップ)

ステップ1: このツールをインストール

ターミナルで:

git clone https://github.com/tedorigawa001/TradingView-MCP.git
cd TradingView-MCP
npm install
npm run build

ステップ2: TradingView をデバッグモードで起動

重要: 普通にアイコンから起動しても AI からは見えません。TradingView が起動中なら一度終了(Cmd+Q)してから、ターミナルで:

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

毎回このコマンドで起動するのが面倒な場合は、エイリアスを登録しておくと tv だけで起動できます:

echo 'alias tv="open -a TradingView --args --remote-debugging-port=9222"' >> ~/.zshrc
source ~/.zshrc

ステップ3: AI エージェントに登録

お使いのエージェントに合わせて設定してください。/path/to/TradingView-MCP は実際にcloneした場所に置き換えます(このリポジトリ内で pwd すると確認できます)。

ターミナルで1コマンド:

claude mcp add tradingview -- node /path/to/TradingView-MCP/build/index.js

または、このリポジトリのフォルダで Claude Code を開けば、同梱の .mcp.json により自動で登録されます。

確認: Claude Code で /mcp を実行し、tradingview が表示されればOK。

方法1 — CLI で追加:

codex mcp add tradingview -- node /path/to/TradingView-MCP/build/index.js

方法2 — 設定ファイル ~/.codex/config.toml に直接追記:

[mcp_servers.tradingview]
command = "node"
args = ["/path/to/TradingView-MCP/build/index.js"]

確認: Codex の画面で /mcp を実行し、tradingview が表示されればOK。

設定ファイル ~/.gemini/config/mcp_config.json を作成(または追記):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/path/to/TradingView-MCP/build/index.js"]
    }
  }
}

IDE から編集する場合は、エージェントパネル右上の「...」→「MCP Servers」→「Manage MCP Servers」→「View raw config」で同じファイルが開きます。保存すると自動で再読み込みされます。

使ってみる

TradingView をデバッグモードで起動した状態で、AI エージェントにこう話しかけてみてください:

今のチャートを分析して

AI が自動で get_chart_context(何が表示されているか)→ get_chart_screenshot(見た目)→ get_ohlcv(数値)などのツールを組み合わせて分析します。

ツール一覧(全24種)

AI が状況に応じて自動で使い分けます。手動で覚える必要はありません。

チャートを読む

チャートを操作する

チャート外のデータ

Pine スクリプト(自作のみ)

これで「ソースを読む → AI が改修 → 保存 → バックテスト」の改善ループが回せます:

BushidoScalp のソースを読んで、ダマシを減らす改良案を実装して。保存してUSDJPYの4時間足でバックテストし、改善したか元と比較して

バックテスト

よくあるトラブル

セキュリティについて

詳細は docs/security-review.md を参照。最低限知っておくべきこと:

• デバッグポート開放中は、同じPC上のプログラムから TradingView のログインセッションを操作できる状態になります。AI と使う時だけデバッグモードで起動し、普段は通常起動にしてください。共有PCでは使わないでください

• このツールは読み取り中心です。唯一の書き込みは自作 Pine スクリプトの保存(save_pine_script)で、confirm 必須・上書きなし・旧バージョン復元可の設計です。注文・アラート作成・ウォッチリスト変更・スクリプト削除は意図的に実装していません

• get_chart_screenshot は画面に見えているものすべて(ウォッチリスト等)を AI に送信します

開発者向け

テスト

npm test                   # ユニットテスト(アプリ不要。モックで検証)
npm run test:integration   # 統合テスト(デバッグモードのアプリが必要)

統合テストはシンボル・時間足を一時的に変更しますが、終了時に元へ復元します。

フォルダ構成

• src/ — TypeScript ソース

  • cdp.ts — CDP クライアント(接続・evaluate・スクリーンショット)

  • tradingview.ts — TradingView ページ内 API 層(チャート・インジケーター・ウォッチリスト)

  • scanner.ts — 公開スキャナー API クライアント(クォート・MTF・スクリーニング)

  • server.ts — MCP ツール定義(依存注入でテスト可能)

  • index.ts — stdio エントリポイント

• test/unit/ — ユニットテスト(モック CDP / モックスキャナー)

• test/smoke.mjs — 実アプリに対する統合スモークテスト

• build/ — tsc 出力(gitignore 済み)

• docs/ — 設計・調査ドキュメント

ドキュメント

• docs/STRATEGY.md — 全体戦略と進捗

• docs/phase0-findings.md / phase3 / phase4 / phase5 — 内部API調査の記録

• docs/security-review.md — セキュリティレビュー

• docs/BACKLOG.md — 今後の改善課題