Servidor MCP de Polygon-io

[!IMPORTANTE]
:test_tube: Este proyecto es experimental y podría estar sujeto a cambios importantes.

Servidor MCP de Polygon.io

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de datos del mercado financiero de Polygon.io a través de una interfaz compatible con LLM.

Descripción general

Este servidor expone todos los puntos finales de la API de Polygon.io como herramientas MCP, lo que proporciona acceso a datos completos del mercado financiero, incluidos:

Agregados y barras de acciones, opciones, divisas y criptomonedas
Operaciones y cotizaciones históricas y en tiempo real
Instantáneas del mercado
Detalles del ticker y datos de referencia
Datos de dividendos y fraccionamientos
Fundamentos financieros
Estado del mercado y días festivos

Instalación

Prerrequisitos

Python 3.10+
Una clave API de Polygon.io
UV astral
- Para las instalaciones existentes, verifique que tenga una versión que admita el comando uvx .

Claude Code

Primero, instala Claude Code

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

Utilice el siguiente comando para agregar el servidor Polygon MCP a su entorno local. Esto supone que uvx está en su $PATH; de lo contrario, deberá proporcionar la ruta completa a 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

Este comando instalará el servidor MCP en su proyecto actual. Si desea instalarlo globalmente, puede ejecutar el comando con el indicador -s <scope> . Consulte claude mcp add --help para obtener más opciones.

Para iniciar Claude Code, ejecute claude en su terminal.

Si es la primera vez que lo usa, siga las instrucciones de configuración para autenticarse.

También puede ejecutar claude mcp add-from-claude-desktop si el servidor MCP ya está instalado para Claude Desktop.

Escritorio de Claude

Siga las instrucciones de instalación de Claude Desktop MCP para completar la instalación inicial y encontrar su archivo de configuración.
Utilice el siguiente ejemplo como referencia para agregar el servidor MCP de Polygon. Asegúrese de completar todos los campos.
1. Ruta encuentra tu ruta a uvx , ejecuta which uvx en tu terminal.
2. Reemplace <your_api_key_here> con su clave API de Polygon.io real.
3. Reemplace <your_home_directory> con la ruta de su directorio de inicio, por ejemplo, /home/username (Mac/Linux) o 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>"
            }
        }
    }
}

Ejemplos de uso

Una vez integrado, puedes solicitarle a Claude que acceda a los datos de 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

Herramientas disponibles

Este servidor MCP implementa todos los puntos finales de la API de Polygon.io como herramientas, incluidos:

get_aggs - Datos de agregados de acciones (OHLC) para un ticker específico
list_trades - Datos comerciales históricos
get_last_trade - Última operación de un símbolo
list_ticker_news - Artículos de noticias recientes para tickers
get_snapshot_ticker : instantánea del mercado actual de un ticker
get_market_status - Estado actual del mercado y horario de negociación
list_stock_financials - Datos financieros fundamentales
Y muchos más...

Cada herramienta sigue la estructura de parámetros del SDK de Polygon.io mientras convierte las respuestas a JSON estándar que los LLM pueden procesar fácilmente.

Desarrollo

Ejecutando localmente

Verifique que tenga los requisitos previos instalados.

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

Depuración

Para depurar y realizar pruebas, recomendamos utilizar el Inspector MCP :

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

Esto iniciará una interfaz de navegador donde podrá interactuar con su servidor MCP directamente y ver la entrada/salida de cada herramienta.

Campo de golf

Contribuyendo

Si encuentra un error o tiene una idea para una nueva función, por favor, coméntelo primero con nosotros enviando un nuevo problema. Responderemos a los problemas en un máximo de 3 semanas. También aceptamos voluntarios si desea enviar un PR para cualquier problema abierto, pero por favor, coméntelo con nosotros con antelación. Los PR que no estén relacionados con un problema existente o que no se hayan discutido con nosotros con antelación generalmente serán rechazados.

Polygon-io MCP Server