Polygon.io MCP Server

重要

:test_tube: このプロジェクトは実験的なものであり、破壊的変更が発生する可能性があります。

Massive.com MCP サーバー

LLM に使いやすいインターフェースを通じて、Massive.com の金融データ API 全体へのアクセスを提供する Model Context Protocol (MCP) サーバーです。

エンドポイントごとに 1 つのツールを公開するのではなく、このサーバーは、Massive.com API 全体を網羅する、組み合わせ可能な 3 つのツール — 検索、呼び出し、クエリ — を LLM に提供します。データはインメモリ SQLite データベースに保存でき、組み込みの金融関数でデータを拡充できます。

ヒント

インストールせずに使いたいですか？Massive はこのサーバーを https://mcp.massive.com でホストしています。 各クライアントでの設定方法については、AI Tools クイックスタートをご覧ください。

ツール

組み込み関数

call_api と query_data の apply パラメーターを使って、API の結果やクエリ出力に関数を適用できます。scope="functions" を指定して search_endpoints を使うと、関数を検索できます。

データ範囲

サーバーは起動時に llms.txt から Massive.com API のすべてのエンドポイントを動的にインデックスするため、API と自動的に同期されます。対象範囲は次のとおりです。

• 株式、オプション、外国為替、暗号資産、先物の集計データ
• リアルタイムおよび過去の取引データと気配値
• 市場スナップショット、値上がり銘柄／値下がり銘柄
• ティッカーの詳細情報と参照データ
• 配当、株式分割、IPO
• 財務ファンダメンタルズ
• アナリスト評価とニュース（Benzinga）
• 米国債利回り、インフレデータ
• 市場の状況と休場日

インストール

前提条件

• Python 3.12+
• Massive.com API キー
  
• Astral UV (v0.4.0+)

Claude Code

まず、Claude Code をインストールします。

npm install -g @anthropic-ai/claude-code

MCP サーバーをインストールし、Claude Code に登録します。

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/[email protected]"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

後で新しいバージョンにアップグレードするには、次のコマンドを実行します。

uv tool upgrade mcp_massive

メモ

uvx または uv run --with からのアップグレードですか？ 以前のバージョンでは、uvx --from ... mcp_massive または uv run --with の使用を推奨していました。これらのコマンドはコールドスタートのたびに依存関係をダウンロードするため、サーバーが Claude の30秒の接続タイムアウトを超えることがあります。上記の uv tool install に切り替えてください。依存関係を一度だけダウンロードし、その後はすぐに起動します。

このコマンドは、現在のプロジェクトに MCP サーバーをインストールします。 グローバルにインストールする場合は、-s <scope> フラグを付けてコマンドを実行します。 その他のオプションについては、claude mcp add --help を参照してください。

Claude Code を起動するには、ターミナルで claude を実行します。

• 初めて使用する場合は、セットアップの指示に従って認証してください。

Claude Desktop 用に MCP サーバーをすでにインストールしている場合は、claude mcp add-from-claude-desktop を実行することもできます。

Claude Desktop

1. Claude Desktop の MCP インストール手順に従って初期インストールを完了し、設定ファイルを確認します。
2. サーバーをインストールします。

uv tool install "mcp_massive @ git+https://github.com/massive-com/[email protected]"

3. インストールされたバイナリのパスを確認します。

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. サーバーを Claude Desktop の設定に追加します。<path_to_mcp_massive> を前の手順の出力に置き換え、残りの項目を入力します。

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

設定

環境変数

トランスポート

デフォルトでは STDIO トランスポートが使用されます。トランスポートは、--transport CLI 引数または MCP_TRANSPORT 環境変数で設定できます（CLI 引数が優先されます）。

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

使用例

統合すると、Claude に Massive.com のデータへのアクセスを依頼できます。

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

開発

ローカルでの実行

前提条件がインストールされていることを確認してください。

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

デバッグ

デバッグとテストには、MCP Inspector の使用をおすすめします。

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

ブラウザーインターフェースが起動し、MCP サーバーを直接操作して、各ツールの入出力を確認できます。

ブラウザーの UI で STDIO トランスポートタイプを選択し、コマンドに uv、引数に run mcp_massive を指定してください。

コードのリンティング

このプロジェクトでは、一般的な開発タスクに just を使用しています。PR を提出する前にコードを lint するには、次のコマンドを実行します。

just lint

これにより ruff format と ruff check --fix が実行され、コードの自動フォーマットと lint の問題の修正が行われます。

リンク

• Massive.com のドキュメント
• Model Context Protocol
• MCP Python SDK

プライバシーポリシー

この MCP サーバーは、Massive.com の API と連携して市場データを取得します。すべてのデータリクエストは、Massive.com のプライバシーポリシーおよび利用規約に従います。

• Massive.com のプライバシーポリシー: https://massive.com/legal/privacy
• データの取り扱い: このサーバーは、ユーザーデータを保存またはキャッシュしません。すべてのリクエストは Massive.com の API に直接転送されます。
• API キー: お客様の Massive.com API キーは、同社の API へのリクエストを認証する目的でのみ使用されます。
• User-Agent: API リクエストには、MCP サーバーのバージョンを含む User-Agent 文字列（例: MCP-Massive/0.x.y）が含まれます。個人を特定できる情報は含まれません。

貢献

バグを見つけた場合や新機能のアイデアがある場合は、まず新しい Issue を作成してご相談ください。 Issue には、最長でも 3 週間以内に対応します。 未解決の Issue に対する PR を提出したい方のご協力も歓迎しますが、事前にご相談ください。 既存の Issue に関連付けられていない、または事前にご相談いただいていない PR は、通常却下されます。