Polygon-io MCP-Server

[!WICHTIG]
_tube: Dieses Projekt ist experimentell und könnte schwerwiegenden Änderungen unterliegen.

Polygon.io MCP-Server

Ein Model Context Protocol (MCP) -Server, der über eine LLM-freundliche Schnittstelle Zugriff auf die Finanzmarktdaten-API von Polygon.io bietet.

Überblick

Dieser Server stellt alle Polygon.io-API-Endpunkte als MCP-Tools bereit und bietet Zugriff auf umfassende Finanzmarktdaten, darunter:

Aktien-, Options-, Devisen- und Krypto-Aggregate und -Balken
Echtzeit- und historische Trades und Kurse
Marktübersichten
Tickerdetails und Referenzdaten
Dividenden- und Splittdaten
Finanzielle Grundlagen
Marktstatus und Feiertage

Installation

Voraussetzungen

Python 3.10+
Ein Polygon.io API-Schlüssel
Astrales UV
- Überprüfen Sie bei vorhandenen Installationen, ob Sie über eine Version verfügen, die den Befehl uvx unterstützt.

Claude Code

Installieren Sie zunächst Claude Code

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

Verwenden Sie den folgenden Befehl, um den Polygon MCP-Server zu Ihrer lokalen Umgebung hinzuzufügen. Dies setzt voraus, dass uvx in Ihrem $PATH enthalten ist. Andernfalls müssen Sie den vollständigen Pfad zu uvx angeben.

# 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

Dieser Befehl installiert den MCP-Server in Ihrem aktuellen Projekt. Für eine globale Installation können Sie den Befehl mit dem Flag -s <scope> ausführen. Weitere Optionen finden Sie unter claude mcp add --help .

Um Claude Code zu starten, führen Sie claude in Ihrem Terminal aus.

Wenn Sie dies zum ersten Mal verwenden, folgen Sie den Setup-Anweisungen zur Authentifizierung

Sie können auch claude mcp add-from-claude-desktop ausführen, wenn der MCP-Server bereits für Claude Desktop installiert ist.

Claude Desktop

Befolgen Sie die Installationsanweisungen von Claude Desktop MCP, um die Erstinstallation abzuschließen und Ihre Konfigurationsdatei zu finden.
Verwenden Sie das folgende Beispiel als Referenz, um den MCP-Server von Polygon hinzuzufügen. Füllen Sie die verschiedenen Felder aus.
1. Pfad: Suchen Sie Ihren Pfad zu uvx und führen Sie which uvx in Ihrem Terminal aus.
2. Ersetzen Sie <your_api_key_here> durch Ihren tatsächlichen Polygon.io-API-Schlüssel.
3. Ersetzen Sie <your_home_directory> durch den Pfad Ihres Home-Verzeichnisses, z. B. /home/username (Mac/Linux) oder 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>"
            }
        }
    }
}

Anwendungsbeispiele

Nach der Integration können Sie Claude auffordern, auf Polygon.io-Daten zuzugreifen:

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

Verfügbare Tools

Dieser MCP-Server implementiert alle Polygon.io-API-Endpunkte als Tools, einschließlich:

get_aggs - Aktienaggregatdaten (OHLC) für einen bestimmten Ticker
list_trades – Historische Handelsdaten
get_last_trade - Letzter Handel für ein Symbol
list_ticker_news – Aktuelle Nachrichtenartikel für Ticker
get_snapshot_ticker - Aktueller Markt-Snapshot für einen Ticker
get_market_status – Aktueller Marktstatus und Handelszeiten
list_stock_financials – Fundamentale Finanzdaten
Und viele mehr...

Jedes Tool folgt der Parameterstruktur des Polygon.io SDK und konvertiert Antworten in Standard-JSON, das LLMs problemlos verarbeiten können.

Entwicklung

Lokal ausführen

Überprüfen Sie, ob die Voraussetzungen installiert sind.

# 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"
      }
    }
  }

Debuggen

Zum Debuggen und Testen empfehlen wir die Verwendung des MCP Inspector :

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

Dadurch wird eine Browseroberfläche gestartet, über die Sie direkt mit Ihrem MCP-Server interagieren und die Eingabe/Ausgabe für jedes Tool sehen können.

Beitragen

Wenn Sie einen Fehler gefunden haben oder eine Idee für eine neue Funktion haben, besprechen Sie dies bitte zunächst mit uns, indem Sie ein neues Problem melden. Wir antworten innerhalb von maximal drei Wochen. Wir freuen uns auch über Freiwillige, die einen PR für offene Probleme einreichen möchten. Bitte besprechen Sie dies vorher mit uns. PRs, die nicht mit einem bestehenden Problem verknüpft sind oder nicht im Voraus mit uns besprochen wurden, werden grundsätzlich abgelehnt.

Polygon-io MCP Server