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)

Related MCP server: CoinMarketCap MCP

Configuración

Clone el repositorio o asegúrese de estar en el directorio del proyecto.
Instalar dependencias:
npm install
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

Construir el servidor:
npm run build
Esto creará un directorio build con el código JavaScript compilado.
Ejecutar el servidor:
npm run start
o directamente:
node build/index.js
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:

. ├── src/ │ ├── index.ts # Server entry point │ ├── marketstackClient.ts # Centralized API client with caching │ ├── cacheConfig.ts # Cache TTL configurations │ └── tools/ │ ├── index.ts # Registers all tool categories │ ├── marketData/ # Market Data tools │ │ └── ... │ ├── referenceData/ # Reference Data tools │ │ └── ... │ ├── financialInstruments/ # Financial Instruments tools │ │ └── ... │ └── wrapToolHandler.ts # Wrapper for tool handlers ├── memory-bank/ # Project documentation │ └── ... ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── eslint.config.js # ESLint configuration ├── .prettierrc # Prettier configuration ├── LICENSE # Project license └── README.md # This file

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.