Servidor MCP de Marketstack

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone diversos puntos finales de la API de Marketstack como herramientas MCP, proporcionando acceso a datos financieros, incluyendo datos de fin de día, intradía, fraccionamientos, dividendos, tickers, bolsas, divisas, zonas horarias, bonos y datos de ETF. Este servidor simplifica la integración de datos de Marketstack en agentes y sistemas compatibles con MCP.

Prerrequisitos

• Node.js (se recomienda v18 o posterior)

• npm (viene con Node.js)

• Clave API de Marketstack

• (Opcional) Cliente o ejecutor compatible con MCP (por ejemplo, extensión VSCode, CLI)

Configuración

1. Clone el repositorio o asegúrese de estar en el directorio del proyecto.

2. Instalar dependencias:

   npm install

3. Configuración:

   • Obtenga una clave API de Marketstack desde https://marketstack.com/ .

   • Configure la variable de entorno MARKETSTACK_API_KEY mediante la configuración de su ejecutor MCP. Este es el método recomendado para una integración fluida con el cliente MCP. Evite usar archivos .env para este propósito al ejecutar mediante un ejecutor MCP.

Construyendo y funcionando

1. Construir el servidor:

   npm run build

   Esto creará un directorio build con el código JavaScript compilado.

2. Ejecutar el servidor:

   npm run start

   o directamente:

   node build/index.js

3. Mediante el ejecutor MCP: Configure su cliente MCP para ejecutar el servidor mediante el transporte stdio. Ejemplo de entrada de configuración de MCP (ajuste /path/to/mcp-marketstack a su ruta actual y reemplace YOUR_API_KEY_HERE con su clave actual):

   "marketstack": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-marketstack/build/index.js" ], "env": { "MARKETSTACK_API_KEY": "YOUR_API_KEY_HERE" } // ... other optional settings ... }

Herramientas disponibles

El servidor expone los puntos finales de la API de Marketstack como herramientas MCP distintas, categorizadas por función:

• Datos de mercado

• Datos de referencia

• Instrumentos financieros

Los agentes de MCP que se conectan al servidor a través de introspección pueden descubrir automáticamente esquemas de entrada detallados y descripciones de cada herramienta.

Estructura del proyecto

El proyecto sigue una estructura modular:

Almacenamiento en caché

El servidor implementa una caché de uso menos reciente (LRU) en memoria para las respuestas de las herramientas. Esto ayuda a reducir las llamadas redundantes a la API de Marketstack, mejorando el rendimiento y cumpliendo con los límites de velocidad.

• Mecanismo: La caché almacena respuestas basadas en el nombre de la herramienta y los parámetros de entrada.

• TTL configurables: Cada herramienta tiene un tiempo de vida (TTL) configurable para sus datos almacenados en caché, definido en src/cacheConfig.ts . Esto permite diferentes duraciones de almacenamiento en caché según la frecuencia de actualización de los datos proporcionados por cada endpoint de Marketstack.

Licencias

Este proyecto está licenciado bajo la Licencia Pública General GNU publicada por la Free Software Foundation, ya sea la versión 3 de la Licencia o (a su elección) cualquier versión posterior. Consulte el archivo LICENSE para más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! Siga el proceso estándar de solicitud de bifurcación y extracción.

Apoyo

Si tiene problemas o preguntas, abra un problema en el repositorio de GitHub.