massive-mcp

Massive.com REST Stocks APIをClaude DesktopおよびClaude Codeに公開するMCP（Model Context Protocol）サーバーです。

FastMCPとhttpx（非同期）を使用して構築されています。Stdioトランスポートを使用します。

対応範囲

デフォルト設定はレスポンスを小さく保つように調整されています（limitを低く設定し、200項目で切り捨てて_truncated_noteを表示）。すべてのページネーション対応ツールはcursorを受け入れ、データがさらに存在する場合はnext_cursorを表示します。

インストール

# Recommended: uv
uv tool install --from . massive-mcp
# or pipx
pipx install .

開発用:

uv sync --extra dev
uv run pytest

設定

環境変数でAPIキーを設定します。両方の認証モードがサポートされています。まずはbearerで開始し、Massiveが401エラーを返す場合はqueryに切り替えてください。

export MASSIVE_API_KEY=sk_live_...
export MASSIVE_AUTH_MODE=bearer   # or "query"

または、.env.exampleを.envにコピーしてください。

接続

Claude Desktop

claude_desktop_config.jsonを編集します：

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

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

{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": ["massive-mcp"],
      "env": {
        "MASSIVE_API_KEY": "sk_live_...",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

Claude Desktopを再起動します。

Claude Code

claude mcp add massive --env MASSIVE_API_KEY=sk_live_... --env MASSIVE_AUTH_MODE=bearer -- uvx massive-mcp

ローカル開発

uv run massive-mcp

MCP Inspectorを使用してツールを手動で実行します：

npx @modelcontextprotocol/inspector uvx massive-mcp

試してみる

接続が完了したら、Claudeに以下のように尋ねてみてください：

• "NVDAの昨日の終値は？"

• "過去12ヶ月のAAPLの配当を取得して。"

• "現在の上昇率トップ10を表示して。"

• "昨日のTSLAの5分足を取得して。"

• "過去30日間のSPYのRSIを教えて。"

コンパニオン・スキル

このリポジトリには、MCPツールを使用してプロフェッショナルなスイング/長期トレードプラン（エントリー、損切り、段階的利確、リスクリワード比、ポジションサイジング）を作成するClaudeスキル massive-trade-analysis も同梱されています。インストール手順については skills/ を参照してください。

注意事項と制限事項

• RESTのみ。WebSocket / FlatFilesのサポートはありません。

• 株式アセットクラスのみ。オプション/FX/暗号資産のエンドポイントはv1の対象外です。

• 一部のエンドポイント（/vX/...）はMassiveによってベータ版としてバージョン管理されており、パスが変更される可能性があります。

• 429レスポンスはRetry-Afterに従って自動的に再試行されます。5xxエラーは指数バックオフ（最大3回）で再試行されます。

• APIキーはログに記録されません。エラー発生時、表示されるURLからapiKeyは削除されます。

ライセンス

MIT