[!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

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 .

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

1. Siga las instrucciones de instalación de Claude Desktop MCP para completar la instalación inicial y encontrar su archivo de configuración.

2. 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).

Ejemplos de uso

Una vez integrado, puedes solicitarle a Claude que acceda a los datos de Polygon.io:

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.

Depuración

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

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

• Documentación de Polygon.io

• Protocolo de contexto modelo

• SDK de Python para MCP

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.