Skip to main content
Glama
zzulanas

QuantData MCP Server

by zzulanas

QuantData MCPサーバー

License: MIT Python 3.11+ PyPI version PyPI downloads

これは非公式のMCPサーバーであり、QuantDataとは一切関係ありません

AIエージェント(Claude Code、Claude Desktopなど)がQuantDataのリアルタイムおよび過去のオプション市場データにアクセスできるようにするMCPサーバーです。

📖 初めての方へ:ステップバイステップのガイドについては、Getting Started Guideをご覧ください。

オプション取引可能なすべてのティッカーをサポート — SPX、SPY、QQQ、AAPL、TSLAなど。0DTEに限らず利用可能です。

利用可能なデータ: GEX/DEX/CEX/VEXエクスポージャーウォール、エクスポージャー期間構造、ネットドリフト、マックスペイン、IVランク、取引サイド統計、建玉(OI)、ネットフロー、統合オーダーフロー、契約OHLCV、および契約統計。

ドキュメント: クリックごとの手順については、GETTING_STARTED.mdを参照してください。

Related MCP server: traders-edge-mcp

クイックスタート

1. インストール

Python 3.11以上が必要です。python3 --versionで確認してください。

  • Mac: brew install python (またはpython.orgからダウンロード)

  • Windows: python.orgからダウンロード(インストール時に「Add to PATH」にチェックを入れること)

PyPIからインストール:

# With pip
pip install quantdata-mcp

# With uv (faster)
uv pip install quantdata-mcp

# Or install as a global tool with uv
uv tool install quantdata-mcp

uvをお持ちでない場合: curl -LsSf https://astral.sh/uv/install.sh | sh (Mac/Linux) または irm https://astral.sh/uv/install.ps1 | iex (Windows) でインストールしてください。pipよりも高速な代替ツールです。

最新版をご希望の場合: GitHubからインストールしてください: pip install git+https://github.com/zzulanas/quantdata-mcp.git

2. 認証情報の取得

QuantDataアカウントから2つの値が必要です。ブラウザを開いてください:

  1. v3.quantdata.us にアクセスしてログイン

  2. DevTools(F12または右クリック→検証)を開き、Networkタブを選択

  3. ページをリロード

  4. QuantData上のチャートやページをクリックすると、APIリクエストが表示されます

  5. core-lb-prod.quantdata.us へのリクエストをクリックするか、上部で /api をフィルタリング

  6. Request Headers 内で以下を探してコピーしてください:

    • authorization — 認証トークン(eyJ...で始まるもの)

    • x-instance-id — インスタンスID(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxのようなUUID)

以下のように表示されます:

3. セットアップの実行

quantdata-mcp setup \
  --auth-token "eyJhbGci..." \
  --instance-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

これにより、QuantDataアカウント上に11個のデータツールを備えた専用ページが作成され、設定が ~/.quantdata-mcp/config.json に保存されます。

4. Claudeへの追加

Claude Code

プロジェクトの .mcp.json (またはグローバルな ~/.claude/mcp.json)に追加してください:

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Claude Codeを再起動します。MCPサーバーに quantdata が表示されるはずです。

Claude Desktop

Claude Desktopの設定ファイルに追加してください:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

注意: quantdata-mcp はシステムPATH上にある必要があります。見つからない場合は、フルパスを使用してください:

which quantdata-mcp   # find the path
{ "command": "/Users/you/.local/bin/quantdata-mcp", "args": ["serve"] }

または uvx を使用してPATHを気にせず実行してください:

{
  "command": "uvx",
  "args": ["--from", "git+https://github.com/zzulanas/quantdata-mcp.git", "quantdata-mcp", "serve"]
}

Claude Desktopを再起動します。ツールリストにQuantDataツールが表示されます。

利用可能なツール

市場概要

ツール

説明

qd_get_market_snapshot

全体概要:GEX + DEXウォール、ドリフト、マックスペイン、取引統計

qd_set_page_date

分析対象のティッカー、セッション日、および/または満期日を切り替え

エクスポージャー(ギリシャ指標)

ツール

説明

主要設定

qd_get_exposure_by_strike

ストライクごとのGEX/DEX/CEX/VEXウォールデータ

greek_type, representation_mode (1%ごと, $1ごと, 生データ), is_net, time_minutes

qd_get_exposure_by_expiration

満期日ごとのギリシャ指標エクスポージャー期間構造

greek_type, representation_mode, is_net, strikes フィルタ

プレミアムフロー

ツール

説明

主要設定

qd_get_net_drift

コール対プットの累積プレミアムフロー

aggregation (1分〜1時間), moneyness, strikes フィルタ

qd_get_net_flow

時間経過に伴うコール/プットのプレミアムフロー

aggregation, data_mode (プレミアム/出来高), moneyness, trade_side, strikes

オーダーフローと取引統計

ツール

説明

主要設定

qd_get_order_flow

統合オーダーフロー — 個別の大型取引

contract_type, moneyness, trade_side, min_premium, strikes

qd_get_trade_side_stats

取引の攻撃性:AA/A/M/B/BBの内訳

data_mode, moneyness, strikes

qd_get_contract_statistics

コール/プットごとの合計プレミアム、取引数、出来高

moneyness, trade_side, strikes

ボラティリティと価格

ツール

説明

主要設定

qd_get_iv_rank

IVランク対過去の範囲

lookback_period, maturity, contract_type

qd_get_contract_price

特定契約のOHLCV価格データ

strike (必須), contract_type, aggregation

建玉(OI)とマックスペイン

ツール

説明

qd_get_max_pain

マックスペインストライク + 現在価格からの距離

qd_get_oi_by_strike

ATM近辺フィルタリング付きの建玉分布

共通パラメータ

すべてのツールは、ティッカー/日付制御のために以下のパラメータを受け入れます:

パラメータ

説明

デフォルト

ticker

オプション取引可能なシンボル (SPX, SPY, QQQ, AAPL, TSLAなど)

SPX

date

セッション日 YYYY-MM-DD

今日

expiration_date

満期日 YYYY-MM-DD

date と同じ (0DTE)

フィルタパラメータ

フィルタリングをサポートするツールは、以下のオプションパラメータを受け入れます:

パラメータ

値

説明

moneyness

OTM, ITM, ATM

マネーネスでフィルタリング (リストを渡して結合可能)

trade_side

AA, A, M, B, BB

取引の攻撃性でフィルタリング

strikes

ドル値、例: [5600.0]

特定のストライクにフィルタリング

contract_type

CALL, PUT

コールまたはプットのみにフィルタリング

min_premium

ドル額、例: 50000

最小プレミアムしきい値 (オーダーフローのみ)

使用例

Claudeに以下のように尋ねてください:

  • "What are the biggest GEX walls right now?" (現在、最大のGEXウォールはどこですか?)

  • "Show me yesterday's DEX walls at 10:30 AM" (昨日の午前10時30分のDEXウォールを見せて)

  • "Pull up the trade side stats — are puts or calls more aggressive today?" (取引サイド統計を出して。今日はプットとコール、どちらが攻撃的ですか?)

  • "Compare the GEX profile at open vs close for last Thursday" (先週木曜日の寄り付きと引けのGEXプロファイルを比較して)

  • "Show me AAPL gamma exposure for the April 17 monthly expiration" (4月17日満期のAAPLガンマエクスポージャーを見せて)

  • "What's the OTM-only net drift for SPX today?" (今日のSPXのOTMのみのネットドリフトは?)

  • "Show me the order flow — just calls with premium over $50K" (オーダーフローを見せて。プレミアムが5万ドル超のコールのみで)

  • "Get the OHLCV for the SPX 6600 call today" (今日のSPX 6600コールのOHLCVを取得して)

  • "What's the IV rank with a 30-day lookback?" (30日ルックバックのIVランクは?)

  • "Show the GEX term structure across all expirations" (全満期にわたるGEX期間構造を表示して)

マルチティッカーサポート

すべてのツールは、オプション取引可能なあらゆるティッカーで動作します。ticker="AAPL"(または任意のシンボル)を渡すだけです。

重要: SPX、SPY、QQQには日次満期があります(デフォルトで0DTEが動作します)。AAPLやTSLAのような株式オプションの場合、expiration_date を有効な満期日(例:毎月第3金曜日)に設定しなければなりません。そうしないとデータが空になります。

> Show me TSLA GEX walls for the April 17 monthly
> qd_get_exposure_by_strike(ticker="TSLA", expiration_date="2026-04-17")

過去データ

すべてのツールは過去の分析をサポートしています。ツールに date= を渡すか、qd_set_page_date を使用してコンテキストを切り替えてください:

> Set the date to 2026-03-26 and show me the GEX walls at 10:00 AM

> qd_set_page_date(date="2026-03-26")
> qd_get_exposure_by_strike(greek_type="GAMMA", time_minutes=600)

時間指定:time_minutes = 深夜0時からの分(570 = 午前9:30、720 = 正午12:00、960 = 午後4:00)。

注意: date は有効な取引日である必要があります(週末や市場休業日は不可)。

仕組み

QuantDataには公式APIがありません。このサーバーは、彼らのWebアプリからリバースエンジニアリングされたRESTエンドポイントを使用しています。各ユーザーは「ページ」上に「ツール」(チャートウィジェット)を持っています。セットアップコマンドは、MCPサーバーがクエリできるように、11種類のデータタイプすべてを備えた専用ページを作成します。

アーキテクチャ:

Claude --> MCP (stdio) --> quantdata-mcp server --> QuantData REST API

認証情報とツールIDはローカルの ~/.quantdata-mcp/config.json に保存されます。

コマンド

quantdata-mcp setup --auth-token <TOKEN> --instance-id <ID>  # One-time setup
quantdata-mcp serve                                           # Start MCP server (used by Claude)

要件

  • Python 3.11+

  • 有効な QuantData サブスクリプション

トラブルシューティング

"Config not found" エラー: 最初に quantdata-mcp setup を実行してください。

認証エラー (401): トークンの有効期限が切れています。Networkタブから新しいトークンを取得し、セットアップを再実行してください。既存のページとツールは再利用されます:

quantdata-mcp setup --auth-token "NEW_TOKEN" --instance-id "SAME_ID"

データが空: 有効なQuantDataサブスクリプションがあること、およびクエリしている日付に市場が開いていたことを確認してください。インデックス以外のティッカー(AAPL、TSLAなど)の場合は、expiration_date を有効なオプション満期日に設定していることを確認してください。

Claude Desktopで "No such file or directory": quantdata-mcp へのフルパスを使用してください(上記のステップ4を参照)。

貢献

バグ報告、QuantDataウィジェットを追加する新しいツール、フォーマッタの改善、ドキュメント作成など、貢献を歓迎します。開発環境のセットアップ、新しいMCPツールの追加方法、PR送信時の規約については CONTRIBUTING.md を参照してください。

ライセンス

MIT — LICENSE を参照。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to discover and retrieve options market-structure data (GEX, gamma flip levels, dealer positioning, skew, max pain, expected-move levels, options flow, and ranked trade setups) from Trading Volatility's public API via natural language.
    17
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides a consolidated 0DTE options cockpit for SPX/SPXW, including chain, Greeks, dealer exposure, volatility term structure, and economic events, using free delayed market data.
    2
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Connects AI assistants to live options market data with 70+ tools for exposure analytics, volatility, strategy signals, and historical backtesting.
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides stock and options market data via the Tradier Brokerage API, enabling AI agents to query financial data through natural language.
    7 npm
    MIT