quant-brain-mcp

Quant Brain MCP

Claude やその他の MCP クライアント向けの市場計算とマルチエージェント調査です。

Quant Brain は、25 個の市場ツールと 4 個の調査ジョブツールを組み合わせています。株価を確認したり、 バックテストを実行したり、仮想取引の規模を決めたり、Codex の専門家を連携させ、根拠、見解の相違、 実行トレースを返すインド株式調査ジョブを開始したりできます。Claude がレポートを確認し、 判断の内容を説明します。

現在の機能と目標とする設計

現在のリリースでは、市場計算と NSE 調査を提供しています。次期アーキテクチャでは、この基盤を拡張し、 ブラウザーを使った調査、追跡可能な根拠、投資仮説のモニタリングを備えたグローバルな調査デスクを 実現します。これらの拡張は計画中であり、現在のリリースをインストールしても有効にはなりません。

領域	現在の実装	拡張予定
市場	NSE 調査ジョブ、個別ツールでのより広範なプロバイダー対応シンボル	インド、米国、その他の市場を対象とした取引所を考慮した調査
データ	Yahoo Finance の履歴データと株価情報。鮮度に制限あり	プロバイダーアダプター、ブローカーフィード、分足ローソク足、鮮度チェック
調査	6 つの Codex ロール。企業分析とクオンツ分析を並行実行	タスクに応じて選択される、開示書類、バリュエーション、マクロ、フォレンジック、ポートフォリオの各専門家
ウェブアクセス	ライブウェブ検索、範囲を限定した公式 HTML/PDF 取得、ブラウザー制御は無効	隔離されたブラウザーワーカー、OCR、より幅広い情報源
検証	スキーマチェック、モデル監査、SDK ツールトレース、取得した情報源の抜粋／ハッシュ、明示的な品質上の不足点	主張ごとの根拠の照合、独立して再現可能な計算
メモリ	保存されたジョブとレポート	投資仮説の履歴、重要な変化のモニタリング、過去の再現
運用	単一ホスト上の Python サービス。デプロイ設定は運用者が実施	パッケージ化されたインストール、中断したジョブの再開、プロバイダープラグイン、オプションのダッシュボード

目標アーキテクチャと 提供ロードマップをご覧ください。

最近の信頼性向上には、内部のストリーム処理と計算処理の上限の分離、財務単位の明示、すべての指標に対する 再現性メタデータの追加、呼び出しの失敗や情報源の文書を利用できない場合のレポート評価の引き下げが含まれます。 検証結果とVPS の更新手順をご覧ください。

現行バージョンの動作

flowchart TB
    User["You"] --> Claude["Claude / MCP client"]
    Claude -->|"Bearer-authenticated HTTP"| Outer["Quant Brain MCP<br/>25 market + 4 research tools"]
    Outer -->|"Direct market requests"| Engines["Calculation engines"]
    Outer -->|"Background research job"| Worker["Codex research roles"]
    Worker --> Search["Live web search"]
    Worker -->|"Separate internal token"| Inner["Private MCP<br/>21 read-only tools"]
    Inner --> Engines
    Engines --> Data["Yahoo Finance / yfinance"]
    Worker --> Report["Evidence + review + execution trace"]
    Report -->|"Poll and retrieve"| Claude
    Claude --> Answer["Answer with sources and limitations"]

オプションの調査ランタイムは、個人用コンピューターまたは VPS など、MCP サーバーと同じホストで実行されます。 Codex がサポートするサインインフローを使用し、認証情報はランタイム内に保持されます。Claude には別個の MCP ベアラートークンが渡されます。Google ログインは不要です。注文の執行は行いません。

まずはこちら

知りたいこと	ガイド
調査をローカルで実行し、Claude Code に接続する	個人向け調査のセットアップ
Claude Desktop/web または別のクライアントに接続する	はじめに
認証付きの市場ツールをデプロイする	デプロイ
VPS 上で個人向け調査を継続的にホストする	VPS デプロイ設計
システムとその境界を理解する	アーキテクチャと図

ローカル調査環境では、python -m pip install -r requirements_research.txt で Python 3.12 の依存関係をインストールし、調査セットアップガイドに従って プライベートトークンを生成し、両方のサーバーを起動して Claude に接続します。 基本の市場サーバーに必要なのは requirements.txt だけです。

Claude Code はローカルの HTTP エンドポイントに接続できます。 Claude Desktop/web のリモート コネクターは Anthropic のクラウドから接続するため、到達可能な HTTPS エンドポイントが必要です。 お使いのコンピューターの localhost には接続できません。ローカルの Desktop stdio 連携は 別の接続方法であり、この調査セットアップでは設定されません。

既存のホスト済みエンドポイントは https://mcp-quant-brain.onrender.com/mcp です。 オペレーターが発行したベアラートークンが必要です。デプロイ済みバージョン、調査設定、 Codex のサインイン状況は個別に確認する必要があります。GitHub へのプッシュや CI の成功だけでは、ホスト済みデプロイの状態を確認できません。

6 つの調査ロール

入力、出力、正確なツール名、現在共有されている権限、提案されている専門ロールの権限については、 エージェントとツールの一覧を参照してください。

ロール	担当
リード	質問を調査計画に分解します。
企業アナリスト	事業、提出書類、ニュースを調査します。
クオンツアナリスト	計算ツールを使用し、データの制約を特定します。
批判的検証役	前提や相反する証拠に異議を唱えます。
監査役	既存の主張を確認し、修正を求め、不確実性を維持します。
統合役	監査済みの結論と未解決の点をまとめます。

企業調査とクオンツ調査は並行して実行されます。Quick では 4 つのロール／呼び出しを使用します。 standard ではリードと批判的検証役が加わり、最大 1 回の修正ラウンドを実施します（6～8 回の呼び出し）。 deep では 2 回の修正ラウンドが可能です（6～10 回の呼び出し）。呼び出しとジョブにはタイムアウトがあります。 レポートは所有者ごとに分離された SQLite ストレージに保存されます。クライアントは 1 つの HTTP リクエストを 開いたままにせず、ポーリングします。LangGraph が調査ロールをオーケストレーションします。企業調査と クオンツ調査が並行して実行され、その後、レビューと回数を制限した修正を経て統合に進みます。 バックエンド内でローカルに実行されるため、LangGraph のクラウドアカウントは不要です。 SQLite にはジョブとレポートが保存されますが、グラフのクラッシュ後の自動再開は有効になっていません。 ワークフローとライフサイクルの図を参照してください。 別々のジョブは一度に 1 つずつ実行されます。ロールの並列実行は、調査ジョブを同時に無制限で 実行できるという意味ではありません。

グローバル調査ワークフローの目標

この図は提案されているコンポーネントを示すもので、現在のツールカタログではありません。

flowchart TD
    Q["Question or monitored event"] --> Plan["Plan tasks and budget"]
    Plan --> F["Filing and browser research"]
    Plan --> A["Quant, valuation, macro and portfolio analysis"]
    Providers["Market and disclosure adapters"] --> Gate["Instrument, time, currency and freshness checks"]
    Gate --> F
    Gate --> A
    F --> E["Captured evidence and calculation records"]
    A --> E
    E --> Review["Deterministic validation, skeptic and auditor"]
    Review --> Report["Cited report with unresolved disagreements"]
    Report --> Client["Claude or another MCP client"]
    Report --> Memory["Thesis history and change monitoring"]
    Memory --> Q

独立した調査は並行して実行され、その結果を受けてレビューが行われます。単純なリクエストは 計算ツールに直接送られます。計画中のブラウザーワーカーは文書やウェブサイトを調査し、 市場データアダプターは株価とローソク足データを提供します。

現行バージョンでサポートされるリクエストの例：

Quant Brain を使って、TCS.NS の quick 調査を実行してください。入手可能な最新の 株価と企業開示を確認してください。完了するまでポーリングし、レポートを取得して、 出典の日付、不確実性、見解の相違を含めて判断を示してください。

利用できること

Claude への質問	Quant Brain の動作
「TCS.NS を調査して、最も強力な反論を説明してください。」	根拠を収集し、クオンツツールを実行して主張を検証し、監査済みレポートを返します。
「RELIANCE.NS と INFY.NS を過去2年間で比較してください。」	過去のデータを取得し、指定された指標またはバックテストを計算します。
「自己資金 ₹100,000、リスク1%で仮想のロング取引のポジションサイズを決めてください。」	前提条件とともに、エントリー価格、損切り価格、株数、目標価格、モデル上の損失を計算します。
「このポートフォリオの過去のリスクを評価してください。」	学習期間の履歴に基づいて配分を調整し、保留した観測データで固定ウェイトを評価します。
「これらの価格を監視してください。」	オーナー単位のアラートを保存します。通知のポーリングと配信には、外部のスケジューラー／クライアントが必要です。

質問から回答まで

1. Claude は質問、1～5個の NSE 銘柄、調査の深さを指定して start_research を呼び出します。
2. Quant Brain はジョブ ID を返し、バックグラウンドで専門エージェントを実行します。
3. Claude は get_research_status をポーリングし、その後 get_research_report を取得します。
4. Claude は根拠、監査警告、実行トレースを使って判断を説明します。

所有するジョブを停止するには、cancel_research を使用します。完了したジョブでも insufficient_evidence を報告する場合があります。実行に成功したからといって、 自信のある回答が得られるとは限りません。直接計算する場合、Claude はエージェントを 起動せずにマーケットツールを呼び出します。

ツール

分野	ツールと機能
調査ジョブ	start_research、get_research_status、get_research_report、cancel_research
トレード調査	気配値、ニュース、ポジションサイズ計算、ウォッチリストのスキャン、永続的な価格アラート
指標	38種類の厳選された指標を公開する、6つのグループ化ツール
ポートフォリオ	時系列ホールドアウト評価を備えた7つの最適化手法
バックテスト	ルールベースの戦略ツール7種類
インテリジェンス	企業プロフィール、セクターランキング、セクターから銘柄へのパイプライン
チャート	レンダリング済み画像として返されるチャートパック

29種類すべてのツール名、パラメーター、レスポンスの形式は、 ツールリファレンスに記載されています。内部調査用 MCP が公開するのは、 読み取り専用ツール21種類のみです。アラート、チャート、調査オーケストレーションは 対象外です。

検証と制限事項

最新のローカル信頼性テストスイートでは、PostgreSQL と VPS アップデーターの ロールバックチェックに加え、HTTP と実際の PNG エクスポートのスモークテストを含む 379件のテストに合格しました。Codex による簡易調査ジョブは、MCP 呼び出し6回と ウェブ検索イベント5回を正常に完了しました。取得がブロックされたソースは明示され、 最終レポートは「根拠不十分／信頼度低」のままでした。正確な対象範囲、過去の結果、 制限事項については検証レポートを参照してください。 公開されたリビジョンの Linux チェックについては CI を確認してください。

• データの鮮度： 無料データは遅延している場合や、利用できない場合があります。 as_of と fetched_at は取得時刻であり、取引時刻が検証済みであることを示すものでは ありません。最近取得したというだけでは、市場価格が最新であるとは確認できません。
• 根拠： SDK トレースはツールが実行されたことを示しますが、すべての主張、引用、 モデルが作成した抜粋を個別に証明するものではありません。verification_basis は model_review です。
• バックテスト： ホールドアウト期間のパフォーマンスは過去の実績です。コストは ツールによって異なります。ポートフォリオのホールドアウト結果には、手数料、スリッページ、 税金、通貨換算が含まれません。
• トレードプラン： ポジションサイズ計算では、表示された損切り価格でのモデル上の 損失に上限を設けます。価格のギャップ、スリッページ、執行条件によって、実際の損失が それを上回る場合があります。
• 対象範囲： 現在、調査ジョブで受け付けるのは NSE 銘柄です。より広範なマーケット ツールも、プロバイダーが対応している場合は米国および BSE の銘柄をサポートします。 自動売買には対応していません。

ドキュメント

• グローバル市場調査のロードマップ案
• アーキテクチャ、ワークフロー、ジョブのライフサイクル、セキュリティ境界
• 評価指標と公開ベンチマークの設計
• エージェント、正確なツールカタログ、提案する権限
• 調査ランタイム、認証、Claude との接続
• ツールリファレンス と プロンプトの例
• 価格アラート
• デプロイと運用
• VPS のトポロジー、認証情報、永続化、受け入れ確認
• Ubuntu VPS インストーラー と 環境テンプレート
• 依存関係のメンテナンス
• 検証結果と残っている制限事項

ライセンス

MIT。