Equity Intel Mcp

equity-intel-mcp

Model Context Protocol を通じて、あらゆる LLM に機関投資家レベルの株式分析を提供します。

一般的な「株価」連携では、価格を返すだけです。このツールは、プロの投資家が実際に注目するシグナル、つまり SEC 提出書類に基づくインサイダーの買い、 著名なバリュー投資家が保有している銘柄、アナリストのコンセンサス、オプションが示唆する値動き、バリュエーションを AI エージェントに提供し、信頼度を加味した単一の判定にまとめます。

無料の公開データ（Yahoo Finance、SEC EDGAR、Dataroma）のみで動作し、データソースが利用できない場合も適切に処理し、存在しないシグナルを捏造することはありません。

# Equity Intelligence — MSFT

## Verdict: Neutral → HOLD
[........|#.......] +11/100  · confidence 69%  · 5 source(s)

| Source        | Signal       | Score  | Conf | Weight |
|---------------|--------------|-------:|-----:|-------:|
| insider       | Bearish      |   -77  |  70% |   0.25 |
| superinvestor | Lean bullish |   +33  | 100% |   0.30 |
| analysts      | Bullish      |   +64  |  75% |   0.15 |
| valuation     | Bullish      |   +91  |  60% |   0.09 |
| options       | Lean bullish |   +19  |  40% |   0.04 |

- insider: Insiders net selling $13.5M over 180d (62 filings).
- superinvestor: 38 tracked superinvestors hold MSFT; 19 buys / 18 sells.
- analysts: 66 analysts: 23 strong buy / 38 buy / 5 hold.
- valuation: Fair value ~$569 vs $391 (+46% upside); health 84/100.
- options: 1-month implied move +/-7.6%; put/call OI 0.53.

---

ツール

ツール	内容	ソース	状態
equity_analyze_ticker	主役のツールです。 すべてのソースを並列で実行し、ソースごとの内訳を含むスコア付きの判定（BUY → AVOID）を返します。	composite	✅
equity_insider_activity	SEC の Form 4 提出書類に基づくインサイダーの純買付と純売却（過去 180 日間）を、米ドル建て金額で加重します。	SEC EDGAR	✅
equity_superinvestors	追跡対象の約 80 人のバリュー投資家のうち、誰がその銘柄を保有しているかと、最近の純買付・純売却を表示します。	Dataroma	✅
equity_get_quote	リアルタイムの価格スナップショットと、52 週間レンジにおける現在位置を表示します。	Yahoo Finance	✅
equity_analyst_consensus	ウォール街の買い・保有・売りのコンセンサスを、強い買いから強い売りまでの評価分布に基づいてスコア化します。	Finnhub	✅
equity_options_signal	1 か月の予想変動幅（ストラドル／現物価格）とプット／コールの未決済建玉の偏りを表示します。主な用途はリスクに応じたポジションサイズの調整です。	Yahoo Finance	✅
equity_valuation	公正価値の推定値（予想 EPS × セクター P/E）と財務健全性スコア（負債、流動性、利益率）を表示します。	Yahoo Finance	✅

すべてのツールは Markdown（人が読みやすいデフォルト形式）または JSON （response_format="json"）を返し、プログラムから利用できます。

---

クイックスタート

git clone https://github.com/cstamigo-droid/equity-intel-mcp equity-intel-mcp
cd equity-intel-mcp
python -m venv .venv && .venv\Scripts\activate     # Windows
pip install -r requirements.txt

copy .env.example .env        # then edit .env (set EDGAR_IDENTITY)
python -m equity_intel_mcp    # starts the MCP server over stdio

動作確認（ライブデータソースにアクセスし、各シグナルを表示します）：

python tests/test_smoke.py AAPL

設定（.env）

# Required by SEC fair-access policy — any "Name [email protected]"
EDGAR_IDENTITY=Your Name [email protected]
# Required by equity_analyst_consensus (free key at finnhub.io)
FINNHUB_API_KEY=your-key-here

---

Claude Desktop で使う

以下を claude_desktop_config.json （Windows の場合は %APPDATA%\Claude\、macOS の場合は ~/Library/Application Support/Claude/）に追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "equity-intel": {
      "command": "python",
      "args": ["-m", "equity_intel_mcp"],
      "cwd": "C:/path/to/equity-intel-mcp",
      "env": { "EDGAR_IDENTITY": "Your Name [email protected]" }
    }
  }
}

あとは Claude に 「NVDA を詳しく分析して」 や 「PLTR ではインサイダーが買っていますか？」 と尋ねるだけです。

---

このような設計にした理由

• 統一されたシグナル仕様。 すべてのソースが同じ形式 （score -100..+100、confidence 0..1、data、summary）を返します。これにより、LLM は 5 種類の形式を解析せずに、異種の証拠を横断して推論できます。
• 適切な縮退動作。 Form 4 に売買活動がない銘柄は、偽の弱気スコアではなく 「シグナルなし」 を返します。データが欠けている場合は信頼度を下げますが、判定を捏造することはありません。
• 信頼度を加味した統合。 統合スコアでは、各ソースの重要度とその信頼度に応じて重み付けするため、弱いシグナルが強いシグナルを上回ることはありません。
• 高い耐障害性とキャッシュ。 ソースごとに短い TTL のキャッシュを設け、エージェントが 1 回のターンで同じティッカーに対して複数のツールを呼び出した際に、レート制限のあるエンドポイントへの過剰なアクセスを避けます。

今後の予定については ROADMAP.md を参照してください。

---

免責事項

調査および教育目的でのみご利用ください。投資助言ではありません。 データはサードパーティの公開ソースから取得しており、遅延または不完全な場合があります。ご自身で十分に調査してください。

ライセンス

MIT