tradingview-mcp

MCPサーバーは、AIエージェントにTradingView中心の取引ツールキットを提供します：スクリーナークエリ、履歴FXデータ、そして—マイルストーンが実装されるにつれ—SMC/ICTパターンスキャン、マークアップ付きチャートレンダリング、バックテスト、Pineツール群、そしてコンパニオンAgent Skillsの一式です。

TradingView, Inc.とは提携関係にありません。 「TradingView」「Pine Script」「Lightweight Charts」はTradingView, Inc.の商標です。

ステータス

M0-M5完了：サーバーはデフォルトで public/data を使用して起動します。オプトインのツールセット：SMCスキャン、チャートレンダリング、バックテスト、FX Replayジャーナル同期、TradingViewアカウントデータ（session）、Pineコンパイル、Desktop CDP（スクリーンショット、ナビゲーション、ライブチャートへの描画、ユーザー自身のインジケーターの読み取り — プロット値とPine描画のFVG/OBゾーン）、および宣言的ストラテジ。また、tv CLI（すべてのツール = JSONを出力するサブコマンド）、10個のコンパニオンスキル、検証済みのClaude Codeプラグインマニフェストを同梱します。未完了項目：M1のトラストゲートは、オーナーによる実際の手動ラベル付きSMCセットアップをまだ待っています。webhookレシーバー、MCP Apps、サンドボックス化されたPythonストラテジのエスケープハッチは延期されています。ロードマップ：docs/PLAN.md。

Related MCP server: TradingView MCP Bridge

Claude Codeプラグインとしてインストール

/plugin marketplace add Miha21222/tradingview-mcp
/plugin install tradingview-mcp@tradingview-mcp-marketplace

インストールでは、オプションの認証情報（OANDA練習用キー、TradingView sessionid）とオペレーター設定（TV_TOOLSETS、TV_READ_ONLY など）を尋ねます。デフォルトの public,data サーフェスには何も必要なく、TradingViewアカウントなしで動作します。PATHに uv が必要です。

クイックスタート

uv sync
uv run python -m tvmcp --check    # list registered tools
uv run python -m tvmcp            # run on stdio
uv run tv --check                 # CLI: list tools
uv run tv tv_data_get_bars '{"symbol":"EURUSD","count":10}'   # CLI: call any tool -> JSON

オプトインの chart ツールセットはヘッドレスChromiumでレンダリングします。有効にする場合は、uv run playwright install chromium を一度実行してください。オプトインのツールセットは TV_TOOLSETS=default,scan,chart,backtest,journal で有効にできます。

Claude Code：リポジトリの .mcp.json は、プロジェクトを信頼するとサーバーを自動的に登録します。

設定（環境変数）

uv run tv tv_setup_doctor を実行すると、すべての前提条件を確認できます。失敗した各チェックは、正確な修正コマンドを返します。

TradingViewの利用規約

デフォルトのツールセットはTradingViewアカウントを一切使用しません。public ツールセットはTradingViewの公開スキャナーエンドポイントと通信し、市場データはDukascopy/OANDAから取得されます。TradingViewの利用規約は、自動データ収集およびデータの表示以外の使用を禁止しています。オプションの session および desktop ツールセット（デフォルトではオフ）は、ご自身のTradingViewアカウント/デスクトップアプリと自己責任で対話します。これらを有効にすることはあなたの明示的な選択であり、TradingViewの利用規約に違反したり、アカウント制限のリスクを招いたりする可能性があります。どちらも初回使用時にstderrへ利用規約/アカウント停止の警告を出力します。このプロジェクトは個人の研究・教育用です。

ライセンス

MIT — LICENSE を参照。TradingView, Inc.とは提携関係にありません。保護/招待制のPineスクリプトは、その作者の所有物のままです。調査ツールは、自分のチャート上のインジケーターのレンダリング済み出力のみを読み取り、そのソースを読むことは決してありません。