HPSILab Quant Finance

HPSILab 株式・オプション分析向け Quant Finance MCP サーバー

AI エージェント向けの株式・オプションのリスク分析です。リモート MCP エンドポイント https://hpsilab.com/mcp に接続し、OAuth でサインインすれば（API キーの貼り付けは不要です）、 エージェントは次の機能を呼び出せます。

• 取引前リスクスキャン：SPY を基準に、ボラティリティ、ベータ、ドローダウン、VaR を固定の合格／警告／不合格基準で評価し、ポジションサイズ、セクターエクスポージャー、相関もチェックします。
• オプション構造：IV 水準、ランクとスキュー、ガンマウォール、コール／プットウォール、最大ペインを分析します。
• 10 取引日分のモンテカルロ価格レンジと、価格が上昇して終了する確率を算出します。
• 1 回の呼び出しで概要を取得できる analyze_stock に加え、AI 予測とバックテストを提供します。

結果は機械可読なエラーを含む構造化 JSON で返され、米国上場株式、ETF、対応するオプションを対象とします。このリポジトリはオープンソースの Python サーバー（MIT）で、ホストされたエンドポイントも同じツール群を提供します。

調査・教育目的でのみご利用ください。HPSILab は投資助言を提供せず、取引も実行しません。

無料の API キーを取得 · 料金 · ツールリファレンス · クライアントの設定 · Python SDK

レジストリ名	io.github.haiyunsky/hpsilab-quant-finance-mcp
バージョン	0.11.1 — ソースチェックアウトでは 0.11.1+source と表示されます
トランスポート	Streamable HTTP（ホスト型） · stdio（PyPI パッケージ）
リモートエンドポイント	https://hpsilab.com/mcp
パッケージ	pip install -U hpsilab-quant-finance-mcp
認証	OAuth サインインまたは Bearer API キー（ホスト型）、HPSILAB_API_KEY（stdio）
ツール	10 — 9 つの金融リサーチツールと register_account

接続：ホスト型 Streamable HTTP

推奨方式です。ローカルへのインストールは不要です。

OAuth サインインを使う場合

MCP OAuth に対応したクライアント（Claude Code、Claude.ai、ChatGPT コネクターなど）では、URL を指定するだけで利用できます。初回利用時に HPSILab のサインインページが開きます。

claude mcp add --transport http hpsilab https://hpsilab.com/mcp

コネクターの UI で、URL https://hpsilab.com/mcp を指定してカスタムコネクターを追加します。

API キーを使用する場合

OAuth に対応していないクライアントやスクリプトの場合：

1. 無料アカウントを登録してサインインし、Settings から API キーを生成します。
2. クライアントのプライベート設定にサーバーを追加し、hpsi_your_key を置き換えます。実際のキーをコミットしたり、チャットに貼り付けたりしないでください。

以下の例は Claude Code の .mcp.json です。他のクライアントでは異なる設定スキーマを使用します。すべて クライアントのセットアップ で説明しています。

{
  "mcpServers": {
    "hpsilab": {
      "type": "http",
      "url": "https://hpsilab.com/mcp",
      "headers": {
        "Authorization": "Bearer hpsi_your_key"
      }
    }
  }
}

3. 接続を確認します。

Use HPSILab to analyze AAPL. Separate observed metrics from interpretation,
identify conflicting signals, and finish with a concise risk summary.

すべての金融リサーチツールを使用するには、サインイン済みのアカウントが必要です。OAuth または有効な API キーをご使用ください。キーの取り扱いとローテーションについては、 認証 をご覧ください。

エージェントを構築していますか？examples/agents には、OpenAI Agents SDK、Claude Agent SDK、LangGraph 向けの、1 ファイルで使えるリスクチェックエージェントがあります。チュートリアル： docs/guide-risk-gate-for-trading-agents.md。

接続：ローカル stdio

ローカルプロセスが必要なクライアントの場合：

pip install -U hpsilab-quant-finance-mcp

この例では、Claude と Cursor がサポートする mcpServers スキーマを使用します。VS Code と GitHub Copilot では、代わりに servers スキーマを使用します。

{
  "mcpServers": {
    "hpsilab": {
      "command": "hpsilab-quant-finance-mcp",
      "env": {
        "HPSILAB_API_KEY": "hpsi_your_key"
      }
    }
  }
}

その後、MCP クライアントを通じて確認します。

Use HPSILab to get the AI prediction for NVDA and summarize the model consensus.

クライアントは MCP の tools/list でツールを検出し、tools/call で呼び出します。ローカルセットアップ および Python の使用方法 をご覧ください。Python からツール関数を直接呼び出す方法も説明しています。

ツール

9 つの金融リサーチツールに加えて、register_account があります。ツール名とパラメーターの意味は、公開互換性契約の一部です。

ツール	返される内容	動作
analyze_stock	株式の方向性分析と定量分析の集約	読み取り専用
get_ai_prediction	次の取引セッションの予測、信頼度、モデルのコンセンサス	読み取り専用
get_iv_radar	IV 水準、ランク、パーセンタイル、スキュー、レジーム	読み取り専用
get_option_pressure	マックスペイン、ガンマウォール、予想変動幅、圧力ゾーン	読み取り専用
get_monte_carlo	10 取引日間のシミュレーション分布と確率	読み取り専用
get_equity_curve	戦略のバックテストとリスク調整後のパフォーマンス	読み取り専用
get_pretrade_risk_scan	ポジション、エクスポージャー、相関、リスクのチェック	読み取り専用
generate_stock_images	ホストされた株式・オプションのチャート成果物	成果物を作成。冪等ではありません
generate_stock_research_report	構造化された Markdown リサーチレポートとタイムスタンプ	成果物を作成。冪等ではありません
register_account	API キーをまだ持たないクライアントからのサインアップ、または既存アカウント用の新しいキー	アカウントを作成してメールを送信。冪等ではありません

リサーチツールには、NVDA、SPY、BRK.B などの取引所ティッカーを 1 つ指定します。企業名は受け付けません。リアルタイムの結果は呼び出しごとに変わる場合があります。成果物を生成するツールはクォータを消費することがあるため、自動的に再試行しないでください。

入力、出力、副作用、ツール選択の指針については、 docs/tools.md をご覧ください。

モンテカルロリサーチの例

シナリオベースのモンテカルロリサーチ出力の可視化例です。結果は選択した入力とモデルの前提に応じて変わります。ツールの詳細については、 get_monte_carlo をご覧ください。

すぐに使えるプロンプト

Claude

Use HPSILab to analyze NVDA. Summarize the directional signal, AI model
consensus, IV regime, options pressure, 10-day Monte Carlo range, and the
three most important risks. Distinguish tool data from interpretation.

Cursor

Use HPSILab's IV radar and option-pressure tools for SPY. Compare IV rank,
percentile, skew, expected move, max pain, gamma wall, and pressure zones.
Return a compact table and do not recommend a trade.

ChatGPT

Run the HPSILab pre-trade risk scan for TSLA. Explain every warning or failed
check, preserve unavailable fields as unavailable, and quote the returned
reason instead of guessing. Do not execute or recommend a trade.

セットアップガイドでは、ChatGPT、Claude、Cursor、VS Code、GitHub Copilot、 Continue、Kimi を取り上げています。各クライアントのトランスポートと設定形式については、 クライアントのセットアップガイド をご覧ください。

エラー、再試行、制限

すべての失敗は、エージェントがパターンマッチングで解釈する必要のある文章ではなく、安定した error_code を持つ構造化オブジェクトです。拒否には、それぞれ異なる対処法があるため、5 種類が重要です。

error_code	意味	解決方法
api_key_required	キーが設定されていません	登録します。下流には何も送信されません
rate_limited	呼び出しが速すぎます（429）	待機します。next_actions に秒数が含まれます
insufficient_credits	Credit 残高がありません（402）	Credit を追加するか、トライアル Credit に登録します
allowance_exhausted	無料評価の上限に達しました（402）	登録するか、メールアドレスを確認します。支払いでは上限は引き上げられません
settlement_unknown	支払いの結果が未確認です	照合します。再試行したり、再度支払ったりしないでください

キーがない場合、パッケージは下流クライアントを構築したりリクエストを送信したりする前に、ローカルで処理を停止します。

{
  "error": "api_key_required",
  "message": "A free API key is required.",
  "register_url": "https://hpsilab.com/register",
  "docs_url": "https://hpsilab.com/developer/v2"
}

401 と 402 のレスポンスは再試行されません。429 は、有効な Retry-After が含まれる場合に限り再試行されます。読み取り専用の呼び出しでは、タイムアウトや復旧可能な 500/502/503/504 レスポンスに対して、有限回数の再試行が行われます。アーティファクトを生成する呼び出しは自動的に再試行されません。また、このパッケージは API キーごとに、1 分間のローリングウィンドウで 10 件までというプロセスローカルの保護策を適用します。これはバーストを防ぐためのものであり、クォータではありません。残高とプランを把握しているのはホステッドサービスだけだからです。

フィールドごとのペイロード、Credit サーキットブレーカー、各対処法の背景については、 docs/authentication.md および docs/python-sdk.md をご覧ください。

HPSILab が選ばれる理由

HPSILab は、アシスタントに型付き入力、構造化出力、ティッカーの検証、機械可読なエラー、そして作り出した指標ではなく専用ツールを提供します。米国上場株式、ETF、対応するオプションデータをサポートしています。カバレッジと制限は、ホステッドサービスとプランによって異なります。

安全性とライセンス

HPSILab は、研究および教育のみを目的としています。出力は不完全、遅延、または誤っている可能性があり、投資、金融、取引に関する助言ではありません。MCP サーバーは、証券会社との接続、注文入力、取引執行の機能を備えていません。

MIT License に基づいてライセンスされています。 コントリビューションを歓迎します。公開スキーマの変更を提案する前に、 AGENTS.md および CONTRIBUTING.md をお読みください。