Equibles

Equibles

Equiblesは、セルフホスト可能なオープンソースの金融データMCPサーバーです。 人間ではなくAIエージェント向けに構築された、Bloomberg Terminalのオープンソース代替です。SEC提出書類やXBRL財務データ、機関投資家の13F保有情報、インサイダーおよび議会議員の取引、FINRA/SECの空売りデータ、FRED経済指標、CFTCおよびCBOEのポジショニング、ファンド提出書類、政府契約、日次株価をスクレイピング、保存、提供し、Model Context Protocol経由で公開するため、Claude、ChatGPT、Cursorなど、あらゆるエージェントから直接照会できます。対象銘柄には米国上場銘柄に加え、欧州の主要取引所に上場する確認済み銘柄も含まれます。Dockerを使ってお使いのハードウェア上で実行でき、無料で、ずっと利用できます。

これはEquiblesのオープンソースコアです。 Equibles Cloudはこのコアをそのまま実行し、さらにツールを追加しています。決算説明会の書き起こしと音声、リアルタイム価格、グリークス付きオプションチェーン、LLMで抽出したKPIとガイダンス、自社株買い、IPO提出書類、経営幹部の異動、バリュエーション倍率、指数構成、ポートフォリオ追跡、米国市場スクリーナーを利用できます。また、欧州銘柄に加えて中国株および香港株も掲載しています。同じプロトコル、同じツール名で、実行するものはありません。詳しくは含まれる機能をご覧ください。

何も実行したくない場合は？ AI アシスタントからhttps://mcp.equibles.com/mcpに接続し、equibles.com/mcpで無料のAPIキーを取得してください。1日100リクエストまで、カード登録は不要です。クライアントごとのセットアップガイドはdaniel3303/stock-market-mcp-serverにあります。

ユーザーガイドと技術ドキュメントについては、docs/をご覧ください。

含まれる機能

セルフホストと記載された機能は、すべてこのリポジトリによってスクレイピング、保存、提供されます。アカウントもキーも不要で、70個のMCPツールを利用できます。Equibles Cloudは同じプロトコルと同じツール名で、このコアをそのまま実行し、さらにツールを追加しています。

ドメイン	データソース	セルフホスト	Equibles Cloud	説明
SEC 提出書類	SEC EDGAR	✅	✅	年次報告書、四半期報告書、臨時報告書（10-K、10-Q、8-K、20-F、6-K、40-F）、委任状資料（DEF 14A、DEFA14A、PRE 14A）、登録届出書（S-1、S-3、S-3ASR、S-4、F-1、F-3、F-3ASR、F-4）、公開買付け（SC TO、SC 14D9）、提出遅延通知（NT 10-K、NT 10-Q、NT 20-F）を全文検索できます
財務諸表	SEC XBRL	✅	✅	会計期間ごとに解析された損益計算書、貸借対照表、キャッシュフローの事実データ
保有状況	SEC 13F-HR	✅	✅	機関投資家の保有状況 — 誰が何をどれだけ保有しているか、その推移
ファンド提出書類	SEC NPORT / N-CEN / Form D	✅	✅	ファンドのポートフォリオ保有状況、登録ファンドの運営情報（サービスプロバイダー、ファンド種別、CRD別アドバイザー）、免除対象の募集（私募）
投資顧問業者	SEC Form ADV	✅	✅	SEC 登録および免除対象の報告義務を負う投資顧問業者 — 運用資産、主たる事務所、従業員数、手数料体系
インサイダー取引	SEC Forms 3/4/5/144	✅	✅	取締役、役員、10％超の株主による取引、年次保有状況報告書、売却予定（Form 144）
議員取引	House/Senate 開示情報	✅	✅	議員による有価証券取引。提出された株式、オプション、債券、その他の金融商品を含みます
空売りデータ	SEC / FINRA	✅	✅	フェイル・トゥ・デリバー（SEC）、日次空売り出来高および空売り残高（FINRA）
経済指標	FRED（連邦準備制度）	✅	✅	金利、インフレ、雇用、GDP、利回りスプレッドなど
株価	Yahoo Finance	✅	✅	テクニカル指標（SMA、RSI、MACD）付きの日次 OHLCV 価格
欧州上場銘柄	ESMA/FCA FIRDS + 取引所ディレクトリ	✅	✅	Euronext（パリ、アムステルダム、ブリュッセル、ダブリン、オスロ、ミラノ、リスボン）、Xetra、Nasdaq Stockholm、ヘルシンキ、コペンハーゲン（メイン市場および First North）、BME、GPW、ロンドン証券取引所（メイン市場および AIM）における検証済み株式上場情報。ISIN と取引所で識別し、上場先の通貨で日次価格を取得できます。ディレクトリアダプターを備えたすべての市場で自動的に動作します。株価、配当、財務諸表、ファンド保有状況の MCP ツールでは MIC:TICKER（XPAR:AIR。docs/equity-identity.md を参照）として指定できます
先物ポジショニング	CFTC	✅	✅	30 種類以上の先物契約に関する建玉明細（COT）データ
市場指標	CBOE	✅	✅	VIX ボラティリティ指数（1990 年以降）とカテゴリー別プット・コール比率
政府契約	USAspending.gov	✅	✅	上場企業への連邦政府契約の授与情報 — 金額、発注機関、日付、NAICS/PSC コード
FDA カタリスト	FDA.gov	✅	✅	諮問委員会（AdComm）の会議カレンダー — バイオテクノロジー／製薬株の規制上のカタリストとなる、予定されている FDA パネルの日程、センター、タイトル
決算説明会のトランスクリプト	企業ウェブキャスト	—	✅	話者情報付きの四半期決算説明会の全文トランスクリプト。提出書類と合わせて検索できます
決算説明会の音声	企業ウェブキャスト	—	✅	録音された説明会そのものを、再生してトランスクリプトと照合できます
決算概要、ガイダンス、ナラティブの変化	決算説明会 + リリース	—	✅	検証者が承認した四半期の要約、説明会での引用、導出されたナラティブの変化、経営陣によるガイダンスの修正、会社が以前に示したガイダンスと報告結果の比較
リアルタイム気配値	ライセンス取得済み市場フィード	—	✅	米国株のリアルタイム気配値
オプションチェーン	ライセンス取得済みオプションフィード	—	✅	満期日と権利行使価格別のチェーン。買値／売値、出来高、未決済建玉、インプライド・ボラティリティ、デルタ／ガンマ／セータ／ベガを含みます
企業 KPI	提出書類 + 決算リリース	—	✅	企業が報告するものの XBRL では標準化されていない業績指標、および GAAP から非 GAAP への調整表
ガイダンス	決算リリース + 説明会	—	✅	経営陣による将来見通し、そのレンジ、四半期ごとの変化
自社株買いと ATM	8-K / 10-Q	—	✅	金額と日付を含む、承認済みの自社株買いプログラムおよび市場価格での株式発行プログラム
IPO フィード	SEC S-1 / F-1	—	✅	募集条件、引受会社、リスク要因、IPO 前の財務情報を含む新規登録
投資家向け広報	企業 IR サイト	—	✅	今後のイベント、カンファレンスへの参加、IR ニュースルームのリリース
経営幹部	SEC 8-K / DEF 14A	—	✅	任命と退任、および報酬概要表の数値
バリュエーション倍率	導出データ	—	✅	現在および過去の P/E、P/S、P/B、EV/EBIT、EV/EBITDA など。各数値の算出に使用した期間も表示します
スクリーナー	導出データ	—	✅	バリュエーション、利益率、成長、保有状況、空売りデータ、配当に基づいて米国の全上場銘柄を絞り込み、市場別に欧州、中国、香港の上場銘柄を閲覧できます
スマートマネー	導出データ	—	✅	インサイダーセンチメントスコア、著名投資家のポートフォリオ、市場全体の議員取引
リスクフラグ	SEC 提出書類	—	✅	継続企業に関する記述と顧客集中に関する開示
市場コンテキスト	導出データ	—	✅	相関のある銘柄、市場カレンダー、市場の開閉状況
指数構成	SEC N-PORT + ファンド保有ファイル	—	✅	S&P 500/400/600、Nasdaq-100、Russell 1000/2000、Dow の構成銘柄と構成変更履歴、およびルールに基づく追加・除外の予測
ポートフォリオ	お客様自身の口座	—	✅	原価基準と実現／未実現損益を含め、株式やオプションの保有状況とウォッチリストを追跡できます。サーバー上で書き込みを行う唯一のツールです

一部のデータがクラウド専用である理由

上記の内容は、このリポジトリで制限されているものは一切ありません。クラウド専用の行は、その生成に自宅では構築しないであろうインフラを必要とするデータです：

• 文字起こしと音声 — 決算説明会はウェブキャストであり、提出書類ではありません。各回をブラウザファームによって発見・録音し、GPU による音声テキスト化と話者ダイアリゼーションに通す必要があります。毎回、毎四半期ごとにです。
• リアルタイム株価とオプションチェーン — ライセンスされたリアルタイムフィードに加え、それらを配信するための常時稼働のストリーミングサービスが必要です。ライセンスも稼働率も、ノート PC 上のコンテナには収まりません。
• KPI、ガイダンス、自社株買い、IPO 条件、経営幹部、リスクフラグ — 提出書類、委任状、決算リリースから、検証パスと人によるレビューキューを備えた LLM 抽出レーンによって取り出されます。これには持続的な推論能力が必要です。
• 投資家向け広報イベントとニュース — 数千社の IR サイトから収集され、ウェブキャストと同じステルスブラウザファームを必要とします。
• マルチプル、スクリーナー、スマートマネー、市場コンテキスト — 派生データであり、これまでにスクレイピングした銘柄だけでなく、市場全体を完全にバックフィルしたコーパス上でのみ意味を持ちます。
• インデックス構成 — すべてのトラッキングファンドの N-PORT スケジュールと、各ファンド自身の保有銘柄ファイルを毎日取得して組み立てられます。これには完全な NPORT コーパスと、それらのファイルがどこへ移動したかを再学習し続けるフェッチャーが必要です。
• ポートフォリオ — スクレイピングされたデータではなく、あなた自身のものであり、あなたのアカウントに紐づけて保存されます。セルフホスト版にはアカウントがないため、保存する対象がありません。

データに加えて、クラウドはすでにバックフィル済みで最新の状態に保たれており、マネージドです — 世話をするスクレイパーはありません。このリポジトリは AGPL-3.0 の下で永久に無料です。クラウドにはカード不要の 1 日 100 リクエストの無料枠があります。

無料枠から始めて、スタックを自分で所有したくなったらいつでもセルフホストしてください。

クイックスタート

Docker Compose（推奨）

すべてを起動する最速の方法です。Docker が必要です。

git clone https://github.com/daniel3303/Equibles.git
cd Equibles
cp .env.example .env
# Edit .env and set SEC_CONTACT_EMAIL (required by SEC EDGAR fair access policy)
docker compose up

これにより以下が起動します：

サービス	ポート	説明
db	5432	ParadeDB（PostgreSQL + pgvector + pg_search）
web	8080	データを閲覧するための Web ポータル
mcp	8081	AI アシスタント向けの MCP サーバー
worker	—	スクレイパー（SEC、FINRA、Congress、FRED、Yahoo、CFTC、CBOE、USAspending、FDA、FIRDS、欧州取引所ディレクトリ）

データのスクレイピングは自動的に開始されます。SEC 提出書類、保有銘柄、インサイダー取引、議会取引は数分以内に投入され始めます。

設定

すべての設定は、プロジェクトルートの .env ファイル (Docker の場合に推奨) または環境変数で構成できます。

FINRA ショートデータ (無料の API キーが必要):

FINRA スクレイパー (ショートボリュームとショートインタレスト) には無料の API キーが必要です。これがない場合、スクレイパーは正常にスキップされ、他のすべてのスクレイパーは通常どおり実行されます。受渡失敗データは SEC から取得され、FINRA の認証情報なしで動作します。

キーを取得するには:

1. FINRA API Console にアクセスしてサインインします (Google アカウントが使用できます)
2. API Credentials メニューを開き、新しい API Key を作成します
3. Client ID と Client Secret をコピーします
4. .env ファイルまたは環境変数に Finra__ClientId と Finra__ClientSecret を設定します

旧来の developer.finra.org の「Teams & Apps」フローは廃止されました — 上記の API Console を使用してください。

FRED 経済データ (無料の API キーが必要):

FRED スクレイパーには、セントルイス連邦準備銀行が提供する無料の API キーが必要です。これがない場合、スクレイパーは正常にスキップされ、他のすべてのスクレイパーは通常どおり実行されます。

キーを取得するには:

1. fred.stlouisfed.org/docs/api/api_key.html で登録します
2. 32 文字の API キーをコピーします
3. .env ファイルまたは環境変数に Fred__ApiKey を設定します

ティッカーのフィルタリング (任意):

デフォルトでは、すべてのティッカーが同期されます。データの同期を特定の銘柄に限定するには、すべてのスクレイパーに適用される単一のティッカーリストを設定します:

# .env — sync only these tickers (applies to all scrapers)
Worker__TickersToSync__0=AAPL
Worker__TickersToSync__1=MSFT
Worker__TickersToSync__2=GOOGL

設定されていない場合、すべての銘柄が同期されます。

最小同期日 (任意):

デフォルトでは、すべてのスクレイパーは 2020 年 1 月から開始します。初回同期を高速化するにはより新しい日付を設定するか、より多くの履歴データを取得するには 2000-01-01 までさかのぼって設定します:

# .env — start syncing from 2024 instead of 2020
Worker__MinSyncDate=2024-01-01

埋め込み (オプトイン):

設定	デフォルト	説明
Embedding__Enabled	false	ベクトル埋め込みの生成を有効にするには true に設定します
Embedding__Provider	Ollama	Ollama (/api/embed) または OpenAI (/v1/embeddings — vLLM、Text-Embeddings-Inference、または OpenAI)
Embedding__BaseUrl	—	埋め込みエンドポイント (例: http://localhost:11434)
Embedding__ModelName	—	モデル名 (例: qwen3-embedding:0.6b)
Embedding__ApiKey	—	サーバーが要求する場合のベアラートークン (例: vLLM の --api-key)
Embedding__BatchSize	10	埋め込みバッチあたりのテキスト数

更新通知 (任意):

設定	デフォルト	説明
CHECK_FOR_UPDATES	true	true の場合、Web ポータルが GitHub Releases を確認し、新しいバージョンが利用可能なときにバナーを表示します。無効にするには false に設定します。

認証 (任意):

設定	デフォルト	説明
AUTH_USERNAME	—	Web ポータルのユーザー名 (空の場合は認証が無効になります)
AUTH_PASSWORD	—	Web ポータルのパスワード (空の場合は認証が無効になります)
MCP_API_KEY	—	MCP サーバーの API キー (空の場合は認証が無効になります)

設定すると、Web ポータルではログインが必要になり、MCP サーバーでは Authorization: Bearer <key> ヘッダーが必要になります。設定しない場合、すべてがオープンアクセスになります (デフォルト)。

更新

Web ポータルは定期的に GitHub Releases を確認し、新しいバージョンが利用可能なときにバナーを表示します (CHECK_FOR_UPDATES=false で無効にできます)。最新リリースに更新するには:

Docker Compose:

git pull
docker compose up -d --build --remove-orphans

それらのサービスを有効なままにするために、任意の Compose オーバーライドファイルをアップグレードコマンドに含めてください。

ソースから:

git pull
dotnet build Equibles.sln

データベースのマイグレーションは起動時に自動的に適用されます。アップグレードする前に、変更履歴 で注目すべき変更を確認してください。

Webポータル

http://localhost:8080 のWebポータルでは、ブラウザーからデータを閲覧できます。

• 株式 — 追跡対象のすべての企業を閲覧・検索し、テクニカル指標（SMA、EMA、RSI、MACD、ボリンジャーバンド）付きの価格チャート、ゴールデンクロス／デッドクロスや連続値動きのバッジ、SPYとのパフォーマンスを確認できます。また、銘柄ごとのタブでは、機関投資家の保有状況、空売りデータ、SEC提出書類、財務諸表、インサイダー取引、売却予定（Form 144）、ファンドの保有状況（NPORT）、ファンドの運用状況（N-CEN）、免除証券募集（Form D）、議会議員の取引を確認できます
• 機関投資家 — 機関投資家（ヘッジファンド、資産運用会社）を閲覧し、ポートフォリオの内訳、業種配分、四半期ごとの活動、バックテスト、並べて比較できる詳細プロフィールを確認できます。届出者はリスク調整後パフォーマンス（ベンチマークに対するアルファ）に基づいてスコア化され、「Smart Money Index」ページでは、最も高いスコアのファンドを集約してコンセンサスシグナルを表示します。保有銘柄のスクリーナーには、届出者数、評価額、浮動株比率、所在地、AUM／ポジション数、業種によるフィルターとCSVエクスポート機能があります
• 投資顧問会社 — SEC登録および免除報告対象の投資顧問会社（/advisers）を、運用資産額の順に閲覧できます。各社のプロフィールでは、規制対象AUM、主たる事務所、従業員数、手数料体系を確認できます
• インサイダー取引 — 過去90日間のインサイダーによる買い、売り、最大規模の取引を表示するダッシュボードです
• 空売り動向 — 空売りが最も多い銘柄のランキング（/most-shorted、FINRAの空売り残高順）と、日次空売り出来高の上位銘柄（/short-volume）を表示します。どちらも日付選択、サーバー側の並べ替え、ページネーションに対応しています
• 経済 — FREDの経済指標を、金利、インフレ、雇用、GDPなどのカテゴリ別に閲覧できます。チャートと統計情報も確認できます
• 先物 — 30種類以上の先物契約（商品、指数、通貨）について、CFTCのトレーダー建玉データと、商業・非商業ポジションのチャートを表示します
• 市場 — CBOEの市場指標を表示します。OHLCチャート付きのVIXボラティリティ指数と、プット／コール比率（株式、指数、合計、VIX、ETP）を確認できます
• 検索 — カテゴリフィルターと日付範囲を使って、株式、機関投資家、インサイダー、議会議員を横断検索できます
• ステータス — システムの稼働状況、ワーカーのステータス、データ件数、エラーログを表示します

MCP サーバー

MCP サーバーは、AI アシスタント（Claude、ChatGPT など）向けに金融データツールを提供します。

• 機関投資家の保有状況 — 上位保有者、保有状況の履歴、機関投資家のポートフォリオと概要、セクター配分、四半期ごとの取引状況、最も多く保有されている株式、コンセンサス保有状況、ファンドの重複、全市場の13F取引状況、申告者の種類およびセクター別の保有者の資金フロー、機関投資家の検索
• インサイダー取引 — インサイダー取引、保有状況の概要、売却予定（Form 144）、インサイダーの検索
• 議会議員の取引 — ティッカー別の取引、議員別の取引、議員の検索
• SEC 文書 — 全文検索、セマンティック検索、文書の閲覧、提出書類内のキーワード検索
• 財務諸表 — ティッカーごとの XBRL ファクト時系列、複数ティッカー間のファクト比較、会計期間ごとの完全な損益計算書／貸借対照表／キャッシュフロー計算書
• ファンドおよびアドバイザーの提出書類 — ファンドのポートフォリオ保有状況（NPORT）、登録ファンドの運用状況（N-CEN）、免除対象の募集（Form D）、SEC 登録済みおよび免除対象の報告義務がある投資アドバイザーの照会と検索（Form ADV）
• 空売りデータ — 日次空売り出来高、全市場で最も多い日次空売り出来高、月2回の空売り残高、複数ティッカーにわたる最新の空売り残高スナップショット
• 経済指標 — FRED データの照会、最新のマクロ経済スナップショット、カテゴリ別の指標検索
• 株価 — 調整後終値を含む日次 OHLCV 履歴、1つ以上のティッカーの最新終値、オンデマンドのテクニカル指標（EMA、ストキャスティクス、平均トゥルーレンジ、オンバランスボリューム、ボリンジャーバンド）
• 先物ポジション — COT ポジションデータ、全契約の最新スナップショット、契約の検索
• 市場指標 — VIX の履歴データ、種類別（株式、指数、合計、VIX、ETP）のプット・コール比率
• 政府契約 — ティッカーが受注した連邦政府契約（発注機関、金額、期間の日付）と、指定期間における連邦政府からの受注総額に基づく上場企業の上位請負業者ランキング（USAspending.gov）
• FDA カタリスト — 指定期間中に予定されている FDA 諮問委員会（AdComm）の会議 — バイオテクノロジー株や製薬株を動かす規制上のカタリストの日付（FDA.gov）

出力形式 (GCF、オプトイン)

デフォルトでは、テーブルツールは Markdown テーブルを返します。より小さくなる場合は代わりに Graph Compact Format が使用され、そうでなければ Markdown にフォールバックします。GCF は Markdown テーブルが表示するのと同じセルを保持しつつ、列名を単一のヘッダーにまとめ、セルごとの | パディングと区切り行を削除します。

これは MarkdownTable.Render を通じてレンダリングされる回答に適用されます。現時点では、出来高が少ない銘柄および関心が低い銘柄のツール、取引所外出来高、受渡失敗、議会取引および議員の開示情報、FRED シリーズおよびカレンダーツール、CFTC ポジション、CBOE レシオ、FDA 諮問委員会、政府契約、そして機関およびアドバイザー検索ツールがこれに該当します。MarkdownTable.Start で回答を組み立て、行を自ら追加するツールはエンコードされません。これらの回答はテーブルの後に切り捨てに関する注記や脚注が続くためです。これには株価、財務諸表、インサイダー、配当、13F ポートフォリオ、ファンド提出書類、提出書類検索のツールが含まれます。これらを共有レンダラー経由にすることは別途追跡されています。

共有サーバーが求める形であるリクエストごとに、X-Equibles-Output-Format: gcf ヘッダーまたは ?output_format=gcf クエリパラメータのいずれかで要求できます (クエリパラメータは、唯一の設定が URL であるクライアントのために用意されています)。markdown も同様に受け付けられるため、呼び出し元は GCF をデフォルトとするサーバーからオプトアウトできます。認識されない値は拒否されるのではなく無視され、サーバー自身のデフォルトが適用されます。

GCF をプロセス全体のデフォルトにするには、EQUIBLES_OUTPUT_FORMAT=gcf を設定してください。形式を指定したリクエストはそれを優先し、何も指定しないリクエストにはそれが適用されます。

リクエストごとの選択は、各ツール呼び出しがそれぞれ独自の HTTP リクエストとして届くことに依存しており、これはステートレスモードとセッションモードの両方でストリーミング可能な HTTP トランスポートが動作する仕組みです。形式はそのリクエストから読み取られ、そのリクエストのみに適用されます。代わりに、以前に開かれた接続で呼び出しをディスパッチするトランスポートでは、その接続を開いたリクエストが要求した内容が引き継がれることになります。

どれだけ節約できるかは回答の形によります。テーブルは圧縮されますが、その周囲の文章は圧縮されないため、長い前置きの中の小さなテーブルは最も節約効果が小さく、短い値が多い幅広のテーブルは最も節約効果が大きくなります。対象となる 3 つのツールからの実際の回答 (日次出来高の 30 セッション、議会取引 25 件、FRED シリーズの月次観測値 24 件) について、デプロイされたサーバーに対してエンドツーエンドで測定したところ、回答テキストは文字数で 7〜13% 短くなります。

これはクライアントがモデルに渡すテキストであり、HTTP ペイロードではありません。JSON はエンコーダーが追加するすべての引用符をエスケープするため、テキストが短くなった同じ回答でもトランスポートのバイト数は増えることがあります。

これは意図的に保守的です。すべてのセル値はそのまま保持されます (コンパクト USD、カンマ区切り、適応的小数、em ダッシュのフォーマットは変更されません — GCF はフレーミングのみを変更し、モデルが読む数値には手を付けません)。また、ヘッダーの列構成に一致しない行は Markdown テーブルにフォールバックするため、結果が失われたり文字化けしたりすることはありません。何も要求しない呼び出し元に対して、何も設定しないサーバーでは出力は変わりません。GCF は MIT ライセンスであり、そのエンコーダーは依存関係ゼロです。

Claude Desktop への接続

Claude Desktop の設定ファイル (claude_desktop_config.json) に以下を追加してください:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

Claude Desktop を再起動すると、Equibles ツールが利用可能になります。その後、「AAPL の機関投資家の上位保有者は誰ですか?」や「Apple の最新 10-K から売上成長に関する議論を検索してください」といった質問ができます。

Claude Code への接続

Claude Code に MCP サーバーを追加します:

claude mcp add equibles --transport http http://localhost:8081/mcp

ChatGPT Desktop への接続

ChatGPT Desktop の設定ファイルに以下を追加してください。

macOS: ~/Library/Application Support/com.openai.chat/mcp.json Windows: %APPDATA%\com.openai.chat\mcp.json

{
  "servers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

ChatGPT Desktop を再起動すると、Equibles のツールを利用できるようになります。

OpenClaw への接続

OpenClaw で、URL http://localhost:8081/mcp（HTTP トランスポート）を指定して MCP サーバーを追加してください。

その他の MCP クライアント

MCP 互換のクライアントであれば、http://localhost:8081/mcp（HTTP トランスポート）に接続できます。

stdio での実行

サーバーをサブプロセスとして起動するクライアントでは、HTTP の代わりに stdin/stdout 経由で実行できます。

dotnet build src/Equibles.Mcp.Server
dotnet run --no-build --project src/Equibles.Mcp.Server -- --stdio

最初にビルドしてください。通常の dotnet run は復元を行い、ビルド出力を stdout に表示するため、プロトコルストリームが破損します。サーバーは通常どおり ConnectionStrings:DefaultConnection を読み込むため、ワーカーがデータを入力するものと同じデータベースを指定してください。ログは stderr に出力されます。API キーとリクエストごとの出力形式ヘッダーおよびクエリパラメーターは適用されません。代わりに、サブプロセスの環境で EQUIBLES_OUTPUT_FORMAT=gcf を設定してください。

ツール

このセルフホスト可能なビルドでは、MCP 経由で 70 個のツールを公開します。ホスト版サーバー https://mcp.equibles.com/mcp は同じコアを実行し、さらに機能を追加しています。カタログ全体とクライアントの設定については、daniel3303/stock-market-mcp-serverをご覧ください。

13F 機関投資家の保有状況

• GetInstitutionCloneBacktest — 提出者の13Fポートフォリオをベンチマークと比較するクローンバックテスト
• GetTopHolders — 株式の主要な機関投資家保有者（13F-HR）。各保有者の種類と測定されたスタイルを表示し、どちらでも絞り込み可能
• GetInstitutionalOwnershipHistory — 四半期ごとの機関投資家保有比率の推移
• GetAllHolders — 株式の開示済み保有者すべてを1つの一覧に表示（13F、13D/13G、インサイダー、ファンド）。他の提出書類とそこに含まれる開示情報をネストして保有者ごとに1行で表示するか、最終親会社ごとにグループ化
• GetOwnershipSummary — 株式の保有者を表示：機関投資家、インサイダー、13D/Gのみの大口保有者、および発行済み株式数に対する割合としての残りの浮動株。ファンドも表示しますが、合計には含めません
• GetBeneficialOwnership — 株式に関するSchedule 13Dおよび13Gの提出者。各提出者について、最新の提出書類とすべての報告者を表示
• GetHolderMix — 保有者の種類、測定されたスタイル、回転率、保有期間、運用資産規模、顧客基盤、プライベートファンド、所在地別に株式の保有者を表示し、各区分の同条件での変化を表示。または、発行済み株式数に対する割合として、N-CENファンドタイプ（インデックスファンド、インデックスETF、アクティブETF、アクティブファンド）別に登録ファンドを表示
• GetOwnershipSignals — あらゆる13Fポートフォリオについて、株式の保有者と保有状況を表示：確信度、混雑度、推定浮動株の保有割合、保有者の集中度、保有期間、保有者の推定取得コストと含み損の株式割合、保有者の重複がある同業銘柄
• GetHolderTargets — 株主ターゲティング：株式は保有していないものの、その株式と保有者が重複する銘柄を保有している13F提出者を、重複銘柄への投資額順に表示し、スタイルと保有者の種類も表示
• GetHolderTypeFlows — 四半期確定時点における、13F提出者の種類別の米国株式市場全体への資金流入・流出。任意でセクター別に分割でき、各区分の前四半期のポートフォリオに対する割合として純資金フローを表示
• GetInstitutionPortfolio — 機関投資家の13Fポートフォリオ。各ポジションの保有期間と推定1株あたり取得コストを表示
• SearchInstitutions — 提出日、13F運用資産残高、ポジション数、保有者の種類を含む、トークン化された名称／CIKの厳密優先検索
• GetTopInstitutionalBuyersSellers — 今四半期における、ある株式の最大の買い増し／削減
• GetMarketWide13FActivity — 市場全体の13Fランキング
• GetMostHeldStocks — 機関投資家の保有の広がり、確信度、混雑度別の株式
• GetInstitutionSummary — 提出者の概要（評価額、集中度、回転率、保有者プロファイル、スタイル帯）
• GetInstitutionStyleHistory — 提出者の測定されたスタイル、回転率、保有期間帯を四半期ごとに表示
• GetInstitutionSectorAllocation — セクター別配分
• GetInstitutionQuarterlyActivity — 前四半期と比較した新規取得／買い増し／削減／売却
• CompareInstitutionPortfolios — 2つの機関投資家間のポートフォリオ重複
• GetInstitutionConsensusHoldings — 2～25の機関投資家によるコンセンサスポートフォリオ

インサイダー取引

• GetInsiderTransactions — Form 4/5のインサイダー取引
• GetInsiderOwnership — 株式数順のインサイダー保有
• GetForm144ProposedSales — Form 144による売却予定
• SearchInsiders — 検証済みの公開名エイリアスを含む、提出書類記載名の厳密優先・完全一致単語検索

SEC提出書類の検索

• SearchDocuments — 必要に応じてティッカーで絞り込める、すべての提出書類を対象としたキーワードとセマンティック検索のハイブリッド
• SearchDocument — 1つの提出書類内を検索
• ListFilings — 市場全体または1社の提出書類を、日付／種類／8-K項目のフィルター付きで閲覧
• ReadDocumentLines — 提出書類の指定行範囲を読み取り

ファンド、ETF、アドバイザー

• SearchInvestmentAdvisers — アドバイザー名のトークン化された厳密優先検索（Form ADV）
• GetInvestmentAdviser — CRDによるADVプロフィール
• GetFundNcenReports — N-CENによるファンド運用情報。ディレクトリ識別子を正確に照合
• GetFundsHoldingStock — 株式を保有するファンド
• GetFormDOfferings — 私募（Form D）
• GetFailsToDeliver — SECのFTDデータ
• SearchFunds — 検証済みのシェアクラスのエイリアスを含む、ファンド／登録者／ティッカーのトークン化された厳密優先検索
• GetFundProfile — ファンドプロフィールとNPORT-Pの保有情報。報告済み件数と保存済み件数を明示

ファンダメンタルズ（XBRL）

• GetFinancialStatement — 1 つの期間末を基準にした損益計算書／貸借対照表／キャッシュフロー計算書。四半期の通貨フローは、個別の四半期または正確に算出した残額で報告され、YTD 合計にはなりません
• GetFinancialFact — 1 つの概念を期間ごとに示し、正確な期間範囲と古い別名のカバレッジ警告を含みます
• CompareFinancialFact — 企業間で概念を比較します
• GetRevenueBreakdown — セグメント／地域／製品別の売上高に加え、報告済みのセグメント営業利益と算出した利益率を示します

経済データ（FRED）

• GetEconomicIndicator — FRED の系列
• GetLatestEconomicIndicators — カテゴリー別の最新値
• SearchEconomicIndicators — 標準的なマクロ経済の別名に対応した、厳密な一致を優先するトークン化済みの厳選系列検索
• GetEconomicCalendar — 米国のマクロ経済指標発表カレンダー

先物（CFTC COT）

• GetCftcPositioning — 契約の COT ポジション状況
• GetLatestCftcPositioning — 最新の COT スナップショット
• SearchCftcMarkets — 名称、コード、標準的な先物シンボルによる、厳密な一致を優先するトークン化済み検索

ボラティリティ（CBOE）

• GetPutCallRatios — プット／コール比率
• GetVixHistory — VIX の日次 OHLC

FDA カレンダー

• GetFdaAdvisoryCommitteeMeetings — FDA 諮問委員会の予定会議

議会議員の取引

• GetCongressionalTrades — ティッカーの取引
• GetMemberTrades — 議員の取引
• GetMemberNetWorth — 議員の純資産の履歴
• SearchCongressMembers — 検証済みの公開名の別名に対応した、厳密な一致を優先するトークン化済み議員名簿検索

空売りデータ（FINRA）

• GetShortVolume — 日次空売り出来高
• GetShortInterest — 月 2 回の空売り残高
• GetShortInterestSnapshot — 市場全体のスナップショット
• GetLargestShortVolume — 日次空売り出来高の上位
• GetShortSqueezeScores — 総合スクイーズスコア
• GetOffExchangeVolume — ダークプール／OTC の出来高

株価

• GetStockPrices — 日次 OHLCV と、保存済みの補助的な調整後終値（異なる場合）
• GetLatestClosingPrices — 最新の終値／変動額／出来高
• GetDividendHistory — 特定の株式または ETF の銘柄について保存された、発表済み現金配当
• GetStochasticOscillator — ストキャスティクス（%K/%D）
• GetAverageTrueRange — 平均真の値幅（ATR）
• GetOnBalanceVolume — オンバランスボリューム（OBV）
• GetBollingerBands — ボリンジャーバンド

政府契約（USAspending）

• GetGovernmentContracts — 企業への連邦政府契約の授与
• GetTopGovernmentContractors — 公開企業の政府契約受注額上位

ベクトル埋め込み（上級者向け、オプトイン）

ベクトル埋め込みを使うと、SEC 提出書類を対象にセマンティック検索できます（例：「Apple の 10-K から売上高の成長に関する説明を探す」）。利用するには、Ollama ランタイム（約 2 GB）と Qwen3-Embedding-0.6B モデル（約 640 MB）をダウンロードする必要があります。

docker compose -f docker-compose.yml -f docker-compose.embedding.yml up

これにより Ollama が追加され、既存の web、MCP、worker サービスで Ollama を使用するように設定されます。

サービス	ポート	説明
embedding	11434	Qwen3-Embedding-0.6B モデルを搭載した Ollama サーバー
embedding-pull	—	worker の起動前にモデルをダウンロードするワンショット処理
worker	—	埋め込み生成を有効にした既存の worker

埋め込みのオーバーライドを設定しなくても、ParadeDB による BM25 全文検索はそのまま利用できます。ベクトル検索は追加機能です。

GPU を必要とせず、どこでも実行できるため、バンドルされた Ollama がデフォルトです。 大規模な埋め込み処理では、Embedding__Provider=OpenAI を vLLM や Text-Embeddings-Inference などのバッチ処理対応サーバーに設定してください。これらは GPU 上で継続的にバッチ処理を行い、大規模なコーパスでは Ollama よりもはるかに高速です。docs/guide/how-to-use-external-embedding-endpoint.md を参照してください。

スクリーンショット

銘柄詳細	銘柄一覧
経済データ	経済指標の詳細

コントリビューション

開発環境のセットアップ、プロジェクトのアーキテクチャ、プラットフォームの拡張方法については CONTRIBUTING.md を参照してください。コントリビューターは Contributor License Agreement に署名する必要があります。これは、プルリクエストを開くとボットによって自動的に処理されます。

ライセンス

AGPL-3.0

作者

Daniel Oliveira