tradingview-mcp-chefy

実際にバックテストを行うトレーダーのための、トークン効率的なTradingView MCP。

これは戦略テスト専用に構築されたフォークです。既存のTradingView MCPはチャートの読み取りや朝のワークフローには適していますが、Pine戦略を反復する際にはトークンを大量に消費します。バックテストを読み取るたびに、全取引リスト、資産曲線、コンソール出力がコンテキストにダンプされるためです。このフォークでは、データがネットワークを通過する前にTradingViewのランタイム内で集約するように読み取り処理を書き換え、デフォルトで要約を返し、詳細が必要な場合にのみ詳細を返すようにしています。

クレジット

このプロジェクトは、以下の2つの先行プロジェクトに基づいています：

• tradesdontlie/tradingview-mcp — オリジナルのCDPブリッジおよびツールインターフェース。困難なスクレイピング作業は彼らによるものです。

• LewisWJackson/tradingview-mcp-jackson — 朝のブリーフィングワークフロー、ルール設定、v2.14以降の起動修正を追加したフォーク。このプロジェクトはそのフォークです。

これらのリポジトリが役に立った場合は、スターを付けてください。

このフォークの違い

正味の効果: 通常のバックテスト読み取りが約50KBから約200バイトに削減されます。集中的な反復セッション（20回以上の実行）では、20ドルのトークン消費と1ドルの消費という違いが生まれます。

ステータス

プレリリース。 フォークのセットアップは完了しています。新しい集約ツールを現在作成中です。v0.2がリリースされるまでは、このリポジトリはLewisWJackson/tradingview-mcp-jacksonと同一の動作をします。現時点で安定性が必要な場合は、そちらを使用してください。

ロードマップ:

• [x] リポジトリのフォーク、構造のセットアップ

• [ ] ブラウザ内集約による backtest_summary

• [ ] backtest_trades_paged カーソルページネーション

• [ ] backtest_equity_summary ダウンサンプリング

• [ ] pine_console_errors フィルタリングツール

• [ ] アップストリームとのトークンコスト比較ベンチマーク

• [ ] LewisWJacksonアップストリームへの非論争的な修正のPR

• [ ] v0.2リリース

クイックスタート

現時点ではアップストリームと同じセットアップです。 v0.2で新しいツールが導入されても、インストールパスは同じままです。mcpServersの設定名のみが変更される可能性があります。

前提条件

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

• Node.js 18+

• Claude Code（または任意のMCPクライアント）

• macOS, Windows, または Linux

インストール

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

デバッグポートを指定してTradingViewを起動

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Claude Codeへの追加

~/.claude/.mcp.json に追加します（既存のサーバーとマージしてください）:

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

YOUR_USERNAME を実際のユーザー名（Mac/Linuxでは echo $USER で確認可能）に置き換えてください。

検証

Claude Codeを再起動し、次のように尋ねてください: "Use tv_health_check to verify TradingView is connected."

アーキテクチャ

Claude Code  ←→  MCP stdio  ←→  src/server.js  ←→  CDP :9222  ←→  TradingView Desktop (Electron)

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

• 集約: バックテスト読み取りの場合、CDP経由で送信されたJS式が、戻る前にTradingViewのランタイム内で削減を実行します。ネットワークホップは同じですが、境界を越えるデータ量は約200分の1になります。

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

• 追加の依存関係ゼロ — アップストリームが使用するもの以外は追加していません

貢献

アップストリームとの双方向の協力:

• 既存ツールのトークン効率改善 → LewisWJacksonのアップストリームにPRし、全員が恩恵を受けられるようにします

• 新しい backtest_* ファミリーのツール → このフォーク内に留めます（MCPの使用に関するメンタルモデルを変更するため）

共有コードパスでバグを見つけた場合は、こちらでIssueを開いてください。対応します。

免責事項

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

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

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

1. TradingViewの利用規約および適用されるすべての法律を遵守して使用する責任は、ユーザー自身が単独で負うこと。

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

3. このツールをTradingViewの市場データの再配布、転売、または商業的利用に使用してはならないこと。

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

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

ライセンス

MIT — LICENSE を参照してください。アップストリームから継承しています。ソースコードのみに適用され、TradingViewのソフトウェア、データ、または商標には適用されません。