TradingView MCP

市場データ、決定的なテクニカル分析、チャート描画、およびオプションのTradingView Superchartsブラウザワークフローのための、ローカルファーストのModel Context ProtocolサーバーおよびループバックREST APIです。

サーバーはstdio上で動作し、ツールが必要な場合にのみローカルビューアーとPlaywrightブラウザを起動します。高レベルの履歴・分析ツールは、デフォルトで管理対象ブラウザを自動的に閉じます。

[!IMPORTANT] これは独立したオープンソースプロジェクトです。TradingViewとは提携、スポンサー、または推奨関係にありません。TradingViewおよびLightweight ChartsはTradingView, Inc.の商標です。ユーザーはTradingViewの利用規約、アカウント権限、取引所の資格、および該当するデータライセンスを遵守する責任があります。

特徴

• 市場調査、相場、OHLCV、分析、チャート状態のためのMCPツール

• 正確なシンボル、期間、日付範囲に対するワンコールの公式TradingViewスクリーンショット

• OHLCV、ギャップ、変化、出来高、エクスポートされたインジケーターフィールド、ローリングパフォーマンス、テクニカル分析を含むワンコールの過去日付コンテキスト

• 決定的なSMA、EMA、RSI、MACD、ボリンジャーバンド、ATR、トレンド、シグナル、サポート/レジスタンス計算

• PNGキャプチャ付きローカルLightweight Chartsビューアー

• CSV、インラインOHLCV、デモデータ、およびオプションの設定済みアップストリームサポート

• アトミックなインジケーター、レベル、カスタムシリーズ、価格ゾーン、マーカーオーバーレイ

• アカウント認証済みTradingView Superchartsナビゲーション、CSVエクスポート、インジケーター、スクリーンショットのためのオプトインPlaywrightワークフロー

• 大きなOHLCV配列がモデルコンテキストを不必要に消費しないように、デフォルトでコンパクトなMCP結果

• ループバックのみのHTTPバインディング、パス封じ込め、入力検証、資格情報フィルタリング、フェイルクローズのブラウザチェック

Related MCP server: TradingView MCP Jackson

アーキテクチャ

MCP client -- stdio --+-- deterministic analysis and chart state
                      +-- on-demand local viewer / PNG capture
                      +-- optional on-demand TradingView browser

REST client -- loopback HTTP -- local viewer and compatible JSON endpoints

ローカルビューアーは決定的な描画サーフェスであり、プロプライエタリなTradingViewチャート機能のクローンではありません。互換性の境界を参照してください。

要件

• Node.js 22以降

• npm

• スクリーンショットまたはブラウザツールを使用する場合、Playwrightを通じてChromiumがインストールされていること

ソースからのインストール

git clone https://github.com/moeuu/tradingview-mcp.git
cd tradingview-mcp
npm ci
npx playwright install chromium
npm run build

Linux CIまたはChromiumシステム依存関係のないマシンの場合:

npx playwright install --with-deps chromium

MCPクライアントの接続

TradingView MCPはクライアントに依存しません。標準のMCP stdioトランスポートを使用し、クライアント固有のAPIを呼び出しません。ローカルプロセスを起動できるMCPクライアントはどれでも使用できます:

node /absolute/path/to/tradingview-mcp/dist/mcp.js

多くのデスクトップおよびエディタクライアントは、この一般的な構成形状を使用します:

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/absolute/path/to/tradingview-mcp/dist/mcp.js"],
      "env": {
        "MARKET_CHART_PORT": "0",
        "MARKET_CHART_DATA_ROOT": "/absolute/path/to/tradingview-mcp/data"
      }
    }
  }
}

必要に応じて外側の構成キーをクライアントに合わせて調整してください。コマンド、引数、環境、MCPプロトコルは同じままです。構成を変更した後はクライアントを再起動してください。MARKET_CHART_PORT=0 は一時的なビューアーポートを選択し、常時リッスンするサービスを回避します。

トランスポートの動作、ライフサイクル、トラブルシューティングについては、MCPクライアントのセットアップと互換性を参照してください。

推奨MCPワークフロー

1. プロバイダーの可用性が不明な場合は、market_get_capabilities を呼び出します。

2. 特定の日付のシンボルに関する包括的な情報には、tradingview_get_day を使用します。

3. 正確な暦日をカバーする公式Supercharts PNGには、tradingview_capture_period を使用します。

4. ワンコールの最近の履歴と決定的な分析には、tradingview_analyze_symbol を使用します。

5. 最近の履歴のみが必要な場合は、tradingview_get_history を使用します。

6. ローカル/ユーザー提供データには、chart_import_csv または chart_set_data を使用します。

7. ローカル分析と可視化には、chart_analyze、chart_apply_overlays、chart_snapshot を使用します。

呼び出し例:

{
  "name": "tradingview_capture_period",
  "arguments": {
    "symbol": "NASDAQ:AAPL",
    "interval": "D",
    "from": "2024-01-02",
    "to": "2024-03-28"
  }
}

{
  "name": "tradingview_get_day",
  "arguments": {
    "symbol": "NASDAQ:AAPL",
    "date": "2024-01-03",
    "interval": "D",
    "timezone": "America/New_York"
  }
}

tradingview_get_day は、週末、祝日、利用できない日付に対して、近くのセッションを黙って代用するのではなく、明示的な no_session_bar ステータスを返します。一致する日付では、セッションOHLCV、読み込まれた場合の前後のバー、前日終値と始値ギャップの変化、日中レンジ、ローリング5/20/50/200期間パフォーマンス、決定的なインジケーターとシグナル、および公式TradingViewチャートエクスポートに存在するすべての追加インジケーター列を返します。日中 interval と includeBars:true を設定すると、その日付に割り当てられたすべてのエクスポートバーを受け取ります。

高レベルのTradingViewツールはデフォルトでブラウザを閉じます。生のバーがMCP応答に必要な場合にのみ includeBars: true を設定し、直後のフォローアップブラウザツールにのみ keepBrowserOpen: true を設定してください。

サーバーは高レベルと詳細の両方のツールを公開します。enabled_tools 許可リストをサポートするクライアントは、特定のワークフローに必要なツールのみを公開できます。

オプションのTradingViewブラウザワークフロー

ブラウザ自動化はデフォルトで無効です。Cookieエクスポートは、必要なセッションCookieのみを含めることができるため、推奨される認証ソースです。資格情報値をMCP引数、リポジトリファイル、クライアント構成、またはプロンプトに貼り付けないでください。

chmod 600 /absolute/path/to/tradingview-cookies.txt
export TRADINGVIEW_BROWSER_ENABLED=true
export TRADINGVIEW_BROWSER_BASE_URL=https://www.tradingview.com
export TRADINGVIEW_BROWSER_COOKIE_FILE=/absolute/path/to/tradingview-cookies.txt
export TRADINGVIEW_BROWSER_AUTH_COOKIE_NAMES=sessionid,sessionid_sign,device_t
export TRADINGVIEW_BROWSER_HEADLESS=true
export TRADINGVIEW_BROWSER_TIMEOUT_MS=120000

認証ファイルはリポジトリの外に置き、1 MiB未満で、POSIXシステムでは所有者のみの権限を持つ必要があります。デフォルトのポリシーは、TradingViewドメインから sessionid、sessionid_sign、device_t のみをインポートします。ローカルストレージはデフォルトではインポートされません。Cookie値、ストレージ値、認証ファイルパスは、MCPツール引数として受け入れられず、MCPまたはREST応答によって返されることもありません。

Cookieエクスポートが利用できない場合は、TRADINGVIEW_BROWSER_AUTH_STATE でPlaywrightストレージ状態ファイルを使用できます。同じCookie許可リストが適用されます。検証済みのワークフローで特定のローカルストレージキーが必要な場合にのみ TRADINGVIEW_BROWSER_AUTH_STORAGE_KEYS を設定してください。デフォルトは空です。

Supercharts UIの可用性、セレクター、エクスポート、アカウントプラン、取引所の資格、遅延/ライブステータスはTradingViewによって制御され、このプロジェクトとは独立して変更される可能性があります。自動化はアカウントのアップグレードや購入を試みることはありません。

詳細と制限については、TradingViewブラウザワークフローを参照してください。

スタンドアロンREST APIとビューアー

REST APIはオプションであり、通常のMCP使用には実行する必要はありません。

npm run serve

デフォルトでは 127.0.0.1:4317 にバインドします:

curl http://127.0.0.1:4317/api/health
curl 'http://127.0.0.1:4317/api/price/DEMO:MARKET?timeframe=60&range=20'

有料/設定済みアップストリームを有効にするか、機密性の高いローカルチャートデータを別のローカルプロセスに公開する前に、ベアラートークンを設定してください:

export MARKET_CHART_API_TOKEN='replace-with-a-long-random-value'
npm run serve

HTTPバインディングはループバックアドレスに制限されています。REST APIリファレンスを参照してください。

構成

.env.example を参照としてコピーしますが、実際の値はシェル、プロセスマネージャー、またはシークレットストアから読み込んでください。アプリケーションは .env ファイルを自動的に読み取りません。

ローカルCSV形式

CSVインポートは MARKET_CHART_DATA_ROOT 内で解決され、昇順のタイムスタンプを含み、設定された制限内に収まる必要があります。

time,open,high,low,close,volume
2026-01-02T00:00:00Z,100,104,99,103,1200000
2026-01-03T00:00:00Z,103,106,101,105,1350000

timestamp または date は time の代わりに使用できます。Unix秒とミリ秒も受け入れられます。

セキュリティモデル

• アイドル状態のstdio MCPプロセスによってネットワークリスナーは作成されません。

• ローカルHTTPルートはループバックのみにバインドし、Host ヘッダーを検証します。

• インポートされたファイルは実パス封じ込めを使用し、シンボリックリンクトラバーサルを拒否します。

• ブラウザ認証は、1つの外部所有者のみのファイルから読み取られ、ドメイン、Cookie名、有効期限、サイズ、およびオプションのローカルストレージキー許可リストによってフィルタリングされます。

• MCPおよびRESTリクエストスキーマは、Cookie、トークン、ストレージ状態、認証ファイルパスを受け入れません。

• ブラウザ操作はステートフルなUI作業を直列化し、資格情報のようなツール入力を拒否します。

• 生成されたブラウザアーティファクト、資格情報、.env ファイル、トレース、ローカル市場データはGitによって無視されます。

• 結果は分析的な観察であり、投資アドバイスや将来のパフォーマンスの保証ではありません。

脆弱性は SECURITY.md に従って報告してください。

開発

npm ci
npx playwright install chromium
npm run check

npm run check は、公開リリースの安全性チェック、リポジトリ全体の英語のみのテキスト検証、厳格なTypeScriptチェック、完全なVitestスイート、および本番ビルドを実行します。

貢献は歓迎します。CONTRIBUTING.md を参照してください。参加することにより、CODE_OF_CONDUCT.md に同意したことになります。

ライセンスと帰属

プロジェクトソースは MITライセンス の下で利用可能です。バンドルされたビューアーはApache-2.0の下でTradingView Lightweight Chartsを使用します。必要な通知は NOTICE、THIRD_PARTY_LICENSES.md、および licenses/Apache-2.0.txt にあります。