Polygon-io MCP サーバー

[！重要]
:test_tube: このプロジェクトは実験段階であり、重大な変更の影響を受ける可能性があります。

Polygon.io MCP サーバー

LLM 対応のインターフェースを通じてPolygon.io金融市場データ API へのアクセスを提供するモデルコンテキストプロトコル (MCP)サーバー。

概要

このサーバーは、すべての Polygon.io API エンドポイントを MCP ツールとして公開し、次のような包括的な金融市場データへのアクセスを提供します。

株式、オプション、外国為替、暗号通貨の集計とバー
リアルタイムおよび過去の取引と相場
市場のスナップショット
ティッカーの詳細と参照データ
配当と株式分割のデータ
財務の基礎
市場の状況と休日

インストール

前提条件

Python 3.10以上
Polygon.io APIキー
アストラルUV
- 既存のインストールの場合は、 uvxコマンドをサポートするバージョンがあることを確認してください。

クロード・コード

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

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

次のコマンドを使用して、Polygon MCPサーバーをローカル環境に追加します。このコマンドは、 uvxが $PATH に含まれていることを前提としています。含まれていない場合は、 uvxへのフルパスを指定する必要があります。

# Claude CLI
claude mcp add polygon -e POLYGON_API_KEY=your_api_key_here -- uvx --from git+https://github.com/polygon-io/mcp_polygon@v0.1.0 mcp_polygon

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

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

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

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

クロードデスクトップ

Claude Desktop MCP のインストール手順に従って初期インストールを完了し、構成ファイルを見つけます。
PolygonのMCPサーバーを追加するには、以下の例を参考にしてください。各フィールドに必ず入力してください。
1. パスはuvxへのパスを見つけ、ターミナルでwhich uvxを実行します。
2. <your_api_key_here>実際の Polygon.io API キーに置き換えます。
3. <your_home_directory>ホームディレクトリのパス (例: /home/username (Mac/Linux) またはC:\Users\username (Windows)) に置き換えます。

{
    "mcpServers": {
        "polygon": {
            "command": "<path_to_your_uvx_install>/uvx",
            "args": [
                "--from",
                "git+https://github.com/polygon-io/mcp_polygon@v0.1.0",
                "mcp_polygon"
            ],
            "env": {
                "POLYGON_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

使用例

統合されると、Claude に Polygon.io データにアクセスするように指示できます。

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

利用可能なツール

この MCP サーバーは、以下を含むすべての Polygon.io API エンドポイントをツールとして実装します。

get_aggs - 特定のティッカーの株価集計（OHLC）データ
list_trades - 過去の取引データ
get_last_trade - シンボルの最新の取引
list_ticker_news - ティッカーの最近のニュース記事
get_snapshot_ticker - ティッカーの現在の市場スナップショット
get_market_status - 現在の市場状況と取引時間
list_stock_financials - 基本的な財務データ
その他にも多数...

各ツールは Polygon.io SDK パラメータ構造に従いながら、応答を LLM が簡単に処理できる標準 JSON に変換します。

発達

ローカルで実行

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

# Sync dependencies
uv sync

# Run the server
POLYGON_API_KEY=your_api_key_here uv run mcp_polygon

  "mcpServers": {
    "polygon": {
      "command": "/your/path/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "/your/path/mcp_polygon",
        "mcp_polygon"
      ],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here",
        "HOME": "/Users/danny"
      }
    }
  }

デバッグ

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

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

これにより、ブラウザインターフェイスが起動し、MCP サーバーと直接対話して、各ツールの入力/出力を確認できるようになります。

リンク

貢献

バグを発見した場合や、新機能のアイデアをお持ちの場合は、まずは新しい問題を報告してご相談ください。問題への対応は最大3週間以内に行います。また、未解決の問題に対するプルリクエスト（PR）の提出を希望されるボランティアの方も歓迎いたしますが、事前にご相談ください。既存の問題に関連しないプルリクエストや、事前にご相談いただけないプルリクエストは、原則として却下されます。

Polygon-io MCP Server