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 22以上(node --version で確認。Node 20はEOL)

• 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(数値)などのツールを組み合わせて分析します。

ツール一覧(全67種)

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

チャートを読む

チャートを操作する

チャート外のデータ

環境認識・評価補助

First-seen collection CLI

npm run collect:first-seen -- --cot-symbol OANDA:EURUSD --cot-symbol OANDA:XAUUSD はCOT、米10年実質金利、CME Daily BulletinのGC全限月OIを収集し、追記専用first-seenログへ記録します。npm run coverage:first-seen はCOT・実質金利・先物OI・政策金利の収集日数、改訂数、最初と最後の観測日をJSONで返します。定期実行時のCOT対象は TRADINGVIEW_MCP_COLLECTION_COT_SYMBOLS=OANDA:EURUSD,OANDA:XAUUSD で指定できます。

npm run collect:policy-rates は、TradingView上でUSD/EUR/JPY/GBP/AUD/NZD/CAD/CHFのECONOMICS:*INTRを順番に読み、値の変更を~/.tradingview-mcp/policy-rate-first-seen.jsonlへ追記します。さらに、8通貨の取得・値ログ保存・チャート復元まで成功した各runを、値の変更有無にかかわらず~/.tradingview-mcp/policy-rate-collection-heartbeats.jsonlへ記録します。これにより、主検定は値のfirst-seen版と収集runの連続性を別々に検証できます。heartbeatの保存先はTRADINGVIEW_MCP_POLICY_RATE_COLLECTION_HEARTBEAT_PATHで変更できます。npm run coverage:first-seenは、この台帳の件数だけでなく、重複を除いた実行日数、同日再実行数、run間の最大営業日age、主検定の5営業日上限を超えた区間数、最終run ageを返します。チャート切替を伴うため、既定スクリプトは明示承認済みの--confirm-chart-switchを渡します。MCPサーバー・他CLIと同じプロセス横断ロックを取得し、各通貨の取得後に元のチャート状態を読み戻して復元します。TradingViewの00:00 UTCバーは公表時刻ではないため、保存値のavailable_atは決定日の翌UTC営業日00:00です。これは会合当日への先読みを避けるための再現可能な保守的境界であり、実際の公表時刻を表すものではありません。

npm run collect:official-policy-rates は探索専用の公式履歴ストアへ保存します。--source ecb_deposit_facility(既定)はECB Deposit Facilityの公式SDMX CSV、--source boc_target_overnight_rateはBoC Valet APIのV39079、--source fred_fed_target_range_midpointはFRED配布の旧Fed単一目標DFEDTARと、2008-12-16以降のtarget range上下限(DFEDTARL/DFEDTARU)の中央値を日付で排他的に接続します。--source rba_cash_rate_targetはRBA F1のFIRMMCRTDで、旧公式XLSの1990-08-02〜2010-12-31と現行日次CSVの2011-01-04以降を検証済み境界で接続します。--source snb_policy_rate_or_libor_target_midpointはSNB policy rateと旧Libor目標レンジ中央値(月末)、--source boj_mpm_policy_decisionsはBoJ会合決定の固定マニフェストを取得します。BoJは量的緩和期に単一短期金利を目標としないため、その境界をvalue: nullとして保存し、古い金利を右連続で使いません。実効FF金利・実勢のovernight cash rateは政策目標と異なるため使いません。いずれも据え置き値を変更日だけへ縮約しますが、raw snapshotには元データの全観測行数・最初/最後の日付も保存し、欠測と据え置きを混同しません。HTTP本文のraw_sha256・取得時刻・Last-Modified由来のvintageを残し、本文は~/.tradingview-mcp/policy-rate-official-raw/<sha256>.rawにもowner-onlyでcontent-addressed保存され、同じハッシュの再取得時は内容を再検証してから再利用します。これは改訂済み履歴であり、前向き/OOS・主検定・採用根拠へ使えません。

npm run collect:fx-history -- --from 2022-01-01T00:00:00.000Z --to 2026-01-01T00:00:00.000Z は、OANDA_FX_HISTORY_ACCOUNT_IDとOANDA_FX_HISTORY_ACCESS_TOKENを環境変数からのみ読み、OANDA v20のEUR_USD・mid・確定済みM15足を取得します。--environment practice(既定)またはliveを明示でき、認証情報・account IDはstdout・台帳・raw証跡へ書き込みません。取得は4,000本以下のページへ分割し、タイムアウト・429・5xxはページ単位で最大3回再試行します。各成功ページはraw保存後に~/.tradingview-mcp/fx-history-m15-manifest.jsonl.checkpointsへ追記されるため、同一範囲を再実行すると保全済みrawを検証・復元し、未完了ページから再開します。各成功レスポンスを~/.tradingview-mcp/fx-history-raw/<sha256>.rawへowner-onlyで内容アドレス保存します。~/.tradingview-mcp/fx-history-m15-manifest.jsonlには、取得範囲、取得時刻、各raw hash、正規化バーhash、件数、最初/最後の足、境界重複数、平日中の非連続区間数を追記します。同一時刻の重複は同値だけを境界重複として除外し、値が異なれば停止します。これは公式の改訂済み履歴であり、保存済みfirst-seen系列ではありません。現段階では長期CPI/NFP/FOMC研究の探索用入力を保全するだけで、既存のOOS採用判定へ自動接続しません。

macOSではcom.tradingview-mcp.policy-rate-collectionを平日10:45 JSTに実行するlaunchdジョブとして登録する。RunAtLoadは設定せず、ログインやMCP再起動の直後に画面を切り替えない。既存の外部first-seen収集は平日10:30と22:30 JSTの二回で、CME OIの速報から確報への改訂を異なる観測時点として残す。これは確報取得を保証する時刻表ではなく、二つのfirst-seen窓を作る運用である。両方が同じchart-operation lockを使うため、MCP操作中は待機または失敗し、別の銘柄状態を復元先として取り違えない。

Event-study falsification audit CLI

npm run audit:event-studies -- --config fvg-audit.json は、凍結済みのイベント研究定義を合成ヌルで校正します。既定は各模型400複製・5,000本・名目α 5%・3foldで、white noise、レジーム切替ボラティリティ、bid-ask bounceを別々の結果として返します。TradingView、ネットワーク、ローカルジャーナルにはアクセスしません。短い動作確認だけなら --model white_noise --replications 20 --bars 1200 で上書きできます。

設定ファイルは研究定義と候補規約だけを持たせます。例えばFVGなら次の形です。

{
  "study": {
    "type": "fvg_retest",
    "definition": {
      "symbol": "SYNTH:FVG_RETEST",
      "timeframe": "15",
      "minimumGapBps": 10,
      "retestWithinBars": 24,
      "minImpulseBodyRatio": 0.5,
      "requireBoundaryHold": true,
      "horizons": [1, 4, 8],
      "targetReturnBps": 20,
      "minimumEvents": 30,
      "eventLimit": 0,
      "confidenceLevel": 0.95,
      "configurationTrials": 1,
      "regime": null,
      "branchFilter": "bearish"
    }
  },
  "candidate": {
    "branch": "fvg_retest_bearish",
    "horizon": 4,
    "minimumEvents": 30,
    "minimumFoldEvents": 5,
    "folds": 3
  }
}

候補率が名目αを上回るかは各模型のWilson区間で判定します。これは採算性や将来の優位性の証明ではなく、指定した採用規約が「何もない系列」にどの頻度で発火するかの監査です。

event aftershock retest をCLI設定へ指定する場合は、実際の経済イベント日時の代わりに eventSchedule を明示します。firstBar、everyBars、maximumEvents は各合成系列における外生イベントの相対スケジュールであり、実イベントの予測・代用・再現を主張するものではありません。

Periodic research-hypothesis collection

npm run collect:research-hypotheses は、前向き仮説の XAUUSD 15分 bearish FVG x trend_down、EURUSD/米10年の日足非追随、EURUSD 50分 lower-wick x trend_down を直列収集します。Bar Replay中は拒否し、既存2ペインを一時切替した後、成功・失敗を問わず元の銘柄と時間足へ復元します。注文、alert、Pine、Studyは変更しません。

集計だけを ~/.tradingview-mcp/research-collection.jsonl へ保存し、primary horizonで確定済みeventが1件以上のときだけ追記します。起動時に3つの仮説IDが研究ジャーナルへ事前登録済みであることを確認し、存在しないIDへ記録しません。MCPサーバとCLIは同じowner-only chart-operation lockを使うため、片方が一時切替中はもう片方が待機します。stdoutのcollection_statusはCLI実行の成否、research_statusは各研究結果の充足度であり、どちらかがpartialなら最上位statusもpartialです。macOSの定期実行は 研究仮説、外部first-seen、政策金利 のlaunchd例をコピーして launchctl で読み込んでください。TradingViewはCDP/debugモードで起動しておく必要があります。研究仮説の例は画面への干渉を抑えるため1時間間隔です。

各ジョブは必要履歴を固定し、FVGは5,000本、日足金利非追随は各系列1,000本、50分特徴量は500本を要求します。不足時は同じ一時チャート上で不足本数だけを追加ロードし、coverageへ初期・追加・最終本数、providerの追加可否、充足判定を記録します。取得できなければinsufficient_loaded_historyとして分析・証拠追記を止め、短い履歴を完全な研究証拠として扱いません。

get_execution_snapshotは開いているTradingViewチャートのbid、ask、lp_time、session状態、realtime-load状態、価格刻みを最優先で読み取ります。lp_timeは同じquote snapshot内のlast-price時刻でありbid/ask個別のexchange timestampではありませんが、その時刻が既定5秒以内、streaming、active session、realtime loadedをすべて満たす場合だけreadyです。対象銘柄がチャートにない場合はscannerへフォールバックしますが、scannerはbid/askの市場側timestampとsession calendarを返さないため、受信時刻を市場時刻へ置き換えません。フォールバックでは既定最大1.2秒間にbid/ask変化を観測できた場合だけreadyとし、価格が動かなければwaitです。これは約定可能性や流動性を保証せず、口座・注文・チャートを変更しません。

compute_position_sizeは数量をブローカー固有のlotではなくinstrument unitとして返します。quantity_step、minimum_quantity、必要ならmaximum_quantityとcontract_multiplierを利用する取引環境の仕様に合わせて明示してください。損失はEntryからStopまでの値幅にcompute_round_trip_cost.total_price_per_unit等の往復コストを加え、口座通貨へ換算して計算します。quote通貨と口座通貨が異なる場合は、口座通貨/quote通貨のレート、symbol、観測時刻がすべて新鮮な場合だけ数量を返します。口座接続、残高取得、発注、永続化は行いません。

実質金利のfirst-seen履歴は既定で~/.tradingview-mcp/real-yield-first-seen.jsonlへ追記されます。保存先はMCPプロセスの環境変数TRADINGVIEW_MCP_REAL_YIELD_HISTORY_PATHで変更できます。初回起動時に取得した過去行は過去の公表時刻へ遡及せず、その起動で実際に保存できた時刻以後だけバックテストに利用されます。

先物建玉のfirst-seen履歴は既定で~/.tradingview-mcp/futures-open-interest-first-seen-v3.jsonlへ追記されます。保存先は環境変数TRADINGVIEW_MCP_FUTURES_OI_HISTORY_PATHで変更できます。get_futures_flow_contextがチャート由来の建玉を読むたび、およびget_cme_gold_open_interestや収集CLIがCME公式GC全限月OIを読むたびに自動で記録されます。チャート近似値とCME公式値は別系列であり、収集開始前の日付についてはvintageを復元できないため、過去分は「今日ダウンロードした改訂後の値」であってその時点で見えていた値ではない、という区別が必要です。

履歴書込み中にプロセスが異常終了して.lockが残った場合、安全のため自動削除せず履歴照会を停止します。他のTradingView-MCPプロセスが動作していないことを確認してから、履歴ファイルと同じ場所の.lockだけを削除してください。

評価CLIはスナップショットのrequest_completed_atを評価時点として、同時点までにfirst-seen済みの実質金利をevaluation_context.real_yield_10yへ自動固定します。現在値や後日の改訂値へフォールバックしません。

npm run evaluate -- --log evaluation.jsonl --snapshot snapshot.json

履歴を分離する場合は--real-yield-history PATH、スナップショットに取得完了時刻がない場合はcanonical UTC形式の--as-of 2026-07-01T12:00:00.000Zを指定します。--as-ofがスナップショットのrequest_completed_atより後なら、先読み防止のため拒否されます。履歴不在時は値を補完せずpoint_in_time_status=blockedとして記録し、履歴破損やロック失敗時はスナップショット自体を追記しません。

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

分析結果をチャートへ重ねる場合は、テンプレートを一度だけsave_pine_scriptで保存し、以後はensure_analysis_overlayで配置・更新・study_id取得を行います。同じ現行版があれば書き込みなしで再利用されるため、分析ごとにPineスクリプトやスタディを増やす必要はありません。旧14入力版からの移行プレビューがcontextBindingRequired:trueを返した場合、confirm後に旧分析を現在の検証済みsymbol/timeframeへ拘束します。期限切れの分析は拒否せず、チャート上でEXPIRED表示になります。反映前の初期値は実分析として扱わず、get_analysis_overlay_statusがunconfiguredを返します。反映後は同ツールで入力・現在価格・描画の整合性を再確認でき、保存されたsymbol/timeframeと現在チャートが違う場合はstale_context、trusted:falseを返して市場判定へ進みません。現在値判定は過去の到達順序を示しません。到達順序はevaluate_analysis_overlay_outcomeが、分析時刻を含む足と形成中足を除外した確定OHLCで評価します。Entry後、Confirmation設定時は後続足での確認を待ち、それ以前のInvalidation接触はシナリオ取消として扱います。有効化後はTarget 1対Stopのfirst-hitを評価します。これは約定や損益を証明するものではなく、同一足で相反水準へ触れた場合や始値ギャップではambiguousを返します。履歴が不足する場合はload_more_history後に再評価するか、evaluation_timeframeに短い時間足を指定します。後者はexpected_timeframeのオーバーレイを検証したまま、指定したchart_indexだけを一時切替し、取得OHLCのsymbol・resolution・バー有無を確認してから元へ復元します。レスポンスのchartState.restoredがfalseの場合は、currentTimeframeを確認して手動復元してください。D/Wは対応し、暦月Mは期間が可変なためnot_evaluableです。

分析ジャーナルは既定で~/.tradingview-mcp/analysis-journal.jsonlへ保存され、TRADINGVIEW_MCP_ANALYSIS_JOURNAL_PATHで変更できます。apply_analysis_overlay(confirm:true)は入力読み戻し一致後に分析定義を自動記録し、事後評価はrecord:trueを明示した場合だけ追記します。同じanalysis_idと同じ定義は冪等、異なる定義へのID再利用と異なる完了ラベルは拒否します。定義衝突時は再試行では解消しないため、新しいanalysis_idを割り当てて再適用してください。ジャーナル書き込みだけが失敗しても反映・評価結果は維持され、レスポンスのjournal.recorded:falseと警告で再試行を促します。較正はtarget_before_stop=1とstop_before_target=0だけを母集団にし、その他は理由別の除外数として返します。

ジャーナルの.lockが60秒を超えて古く、記録された所有PIDが存在しない場合だけ自動回収します。所有PIDが生存中、確認不能、またはロックが新しい場合は奪取せず、タイムアウトエラーに対象パスを表示します。表示されたロックを手動削除する場合は、他のTradingView-MCPプロセスが利用していないことを先に確認してください。

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

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

バックテスト

よくあるトラブル

セキュリティについて

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

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

• このツールは読み取り中心です。書き込みは自作Pineの非破壊保存、チャート上の自作Pine追加・入力変更・所有確認付き削除、監査済み分析からの期限付き価格アラート作成、Bar Replayの開始・ステップ・終了に限定しています。save_pine_script、apply_analysis_overlay、ensure_analysis_overlay、remove_owned_study、create_analysis_alerts、リプレイ開始・終了はconfirmフローを持ちます。注文、Replay Trading、リプレイautoplay、既存アラートの変更・再開・削除、Webhook、ウォッチリスト変更、Pineライブラリのスクリプト削除は意図的に実装していません

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

開発者向け

テスト

npm test                   # ユニットテスト(アプリ不要。モックで検証)
npm run test:integration   # 統合テスト(デバッグモードのアプリが必要)
npm run test:e2e           # MCP stdio経由の実機E2E(下記設定が必要)

Pull RequestとpushではGitHub ActionsがNode.js 22/24のnpm testと、high以上を拒否するnpm auditを実行します。

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

Walk-forward E2Eは、現在のチャートと保存済みStrategyに合うツール引数を TRADINGVIEW_WALK_FORWARD_E2E_CONFIGへJSONで設定して実行します。confirmはテスト側が管理するため含めません。

TRADINGVIEW_WALK_FORWARD_E2E_CONFIG='{"expected_symbol":"OANDA:USDJPY","expected_timeframe":"240","candidates":[{"pine_id":"USER;YOUR_PINE_ID","inputs":[{"id":"in_20","value":false}]},{"pine_id":"USER;YOUR_PINE_ID","inputs":[{"id":"in_20","value":true}]}],"folds":[{"fold_id":"f1","train_from":"2025-03-01T00:00:00.000Z","train_to":"2025-09-01T00:00:00.000Z","test_from":"2025-09-02T00:00:00.000Z","test_to":"2025-12-01T00:00:00.000Z"},{"fold_id":"f2","train_from":"2025-03-01T00:00:00.000Z","train_to":"2025-12-01T00:00:00.000Z","test_from":"2025-12-02T00:00:00.000Z","test_to":"2026-03-01T00:00:00.000Z"}],"mode":"anchored","embargo_bars":1,"minimum_train_trades":5,"minimum_test_trades":3,"selection_metric":"expectancy","max_runtime_seconds":180}' npm run test:e2e

分析監視アラート E2Eは、配置済み分析オーバーレイに適合する設定を TRADINGVIEW_ANALYSIS_ALERTS_E2E_CONFIG へ指定して実行します。

TRADINGVIEW_ANALYSIS_ALERTS_E2E_CONFIG='{"pine_id":"USER;YOUR_PINE_ID","expected_symbol":"OANDA:USDJPY","expected_timeframe":"4H","analysis_id":"USDJPY-20260724-001","confirm":false}' npm run test:e2e

Fair Value Gap Retest イベントスタディ E2Eは、チャートに適合する設定を TRADINGVIEW_FVG_RETEST_E2E_CONFIG へ指定して実行します。

TRADINGVIEW_FVG_RETEST_E2E_CONFIG='{"expected_symbol":"OANDA:EURUSD","expected_timeframe":"60","count":5000,"condition":{"type":"fair_value_gap_retest","minimum_gap_bps":10,"retest_within_bars":24,"min_impulse_body_ratio":0.5,"require_boundary_hold":true},"horizons":[1,2,4,8],"target_return_bps":20,"minimum_events":1,"event_limit":50,"confidence_level":0.95,"configuration_trials":1}' npm run test:e2e

先物フローE2Eは、TRADINGVIEW_FUTURES_FLOW_E2E_CONFIG へ open_interest_study_id、open_interest_plot_title、および値の意味を固定するopen_interest_scopeを必ず含める必要があります。open_interest_scope は open_interest_data かスタディ明示指定と対で使うもので、自動検出のみに任せる場合は指定できません(自動検出は公式のfront-month Open Interestスタディしか読まないため、scopeを宣言できてしまうと front-month の値が集計系列に紛れ込みます)。建玉が取得できない設定は明示的に失敗します(黙って素通りすると first-seen 収集が壊れていても気づけないため)。収集先は一時ファイルへ切り替わるので、実運用のログは汚染されません。

TRADINGVIEW_FUTURES_FLOW_E2E_CONFIG='{"target_symbol":"OANDA:XAUUSD","futures_chart_index":1,"expected_futures_symbol":"COMEX_DL:GC1!","count":250,"observation_limit":0,"minimum_observations":100,"cot_weeks":1,"open_interest_study_id":"YOUR_STUDY_ID","open_interest_plot_title":"Total OI","open_interest_scope":"all_months_aggregated"}' npm run test:e2e

E2Eは誤ったチャート束縛の拒否、dry-runの決定性、train-only選定、非選択候補OOSの非公開に加え、研究protocol検証、ledger stress、seed固定bootstrap、アラート実作成・所有名照合、レスポンス非増幅、実行後のチャート完全復元を検証します。設定がない場合はskipします。

フォルダ構成

• src/ — TypeScript ソース

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

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

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

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

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

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

• test/e2e/ — MCP stdioから実アプリまで通す設定駆動E2Eテスト

• 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 — 今後の改善課題