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

Polygon.io MCP サーバー

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

概要

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

• 株式、オプション、外国為替、暗号通貨の集計とバー

• リアルタイムおよび過去の取引と相場

• 市場のスナップショット

• ティッカーの詳細と参照データ

• 配当と株式分割のデータ

• 財務の基礎

• 市場の状況と休日

インストール

前提条件

• Python 3.10以上

• Polygon.io APIキー

• アストラルUV

  • 既存のインストールの場合は、 uvxコマンドをサポートするバージョンがあることを確認してください。

クロード・コード

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

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

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

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

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

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

クロードデスクトップ

1. Claude Desktop MCP のインストール手順に従って初期インストールを完了し、構成ファイルを見つけます。

2. 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)) に置き換えます。

使用例

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

利用可能なツール

この 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 に変換します。

発達

ローカルで実行

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

デバッグ

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

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

リンク

• Polygon.io ドキュメント

• モデルコンテキストプロトコル

• MCP Python SDK

貢献

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