finance-mcp

Un servidor remoto centrado en el Protocolo de Contexto de Modelo (MCP) para datos de mercado, diseñado para Cloudflare Workers y clientes de IA como ChatGPT/Codex.

Herramientas

• stock_quote — metadatos de cotización más recientes / casi en tiempo real para hasta 10 tickers

• price_history — historial OHLCV con intervalos intradía y diarios

• option_chain — vencimientos de opciones, calls, puts, IV, volumen e interés abierto

• finance_news — búsqueda de noticias de empresas/tickers

• market_snapshot — instantánea del S&P 500, Nasdaq Composite, Dow Jones y VIX

Related MCP server: Financial Modeling Prep (FMP) MCP Server

Fuentes de datos

La primera versión usa los endpoints públicos/no oficiales de Yahoo Finance. Las reglas de la bolsa y de los proveedores de datos determinan la latencia real. Trata las cotizaciones como casi en tiempo real a menos que tu acuerdo con el proveedor garantice explícitamente datos en tiempo real. Los datos de opciones pueden estar retrasados; verifica las decisiones de ejecución contra tu bróker o el libro de órdenes.

Desarrollo local

npm install
npm run dev

Comprobación de estado:

http://localhost:8787/health

Endpoint de MCP:

http://localhost:8787/mcp

Despliegue en Cloudflare Workers

npm install
npx wrangler login
npm run deploy

Después del despliegue, Wrangler devuelve una URL de Workers. Tu endpoint de MCP remoto es:

https://<worker-name>.<account-subdomain>.workers.dev/mcp

Usa /health para verificar que el Worker es accesible.

Conectar un cliente MCP

Configura la URL remota de MCP que termine en /mcp. Este proyecto usa Streamable HTTP a través del manejador MCP sin estado de Cloudflare.

Ejemplos de prompts

• Get AAPL and NVDA latest quotes.

• Show AAPL 5-day 5-minute price history.

• Get the nearest AAPL option chain and identify the highest-volume calls and puts.

• Find the latest Apple finance news.

• Give me a US market snapshot.

Hoja de ruta

Los próximos módulos pueden añadir presentaciones a la SEC, datos macro de FRED, tenencias institucionales, transacciones de insiders, fuentes de datos de opciones compatibles con Cboe/OPRA y proveedores de datos de mercado en tiempo real de nivel profesional.