Servidor MCP de Yahoo Finance

👁 PyPI version
👁 Python
👁 CI
👁 License: MIT

Un servidor de Model Context Protocol (MCP) que proporciona a los asistentes de IA acceso a datos de Yahoo Finance a través de yfinance. Consulta información bursátil, noticias financieras, clasificaciones sectoriales y genera gráficos financieros profesionales, todo desde tu chat de IA.

Características

• Datos bursátiles — Información de la empresa, estados financieros, métricas de valoración, dividendos y datos de negociación

• Estados financieros — Estado de resultados y balance general con datos históricos (EBIT, capital invertido, etc.)

• Noticias financieras — Artículos de noticias recientes y comunicados de prensa para cualquier ticker

• Búsqueda — Encuentra acciones, ETFs y noticias en Yahoo Finance

• Clasificaciones sectoriales — Principales ETFs, fondos mutuos, empresas, líderes en crecimiento y empresas con mejor rendimiento por sector

• Historial de precios — Datos históricos OHLCV como tablas markdown o gráficos profesionales

• Generación de gráficos — Gráficos de velas, VWAP y perfil de volumen devueltos como imágenes WebP

Related MCP server: MCP Yahoo Finance

Herramientas

yfinance_get_ticker_info

Recupera datos bursátiles completos, incluyendo información de la empresa, estados financieros, métricas de negociación y datos de gobernanza.

Devuelve: Objeto JSON con detalles de la empresa, datos de precios, métricas de valoración, información de negociación, dividendos, estados financieros e indicadores de rendimiento.

yfinance_get_ticker_news

Obtén artículos de noticias recientes y comunicados de prensa para una acción específica.

Devuelve: Matriz JSON de noticias con título, resumen, fecha de publicación, proveedor, URL y miniatura.

yfinance_search

Busca acciones, ETFs y artículos de noticias en Yahoo Finance.

Devuelve: Cotizaciones y/o resultados de noticias coincidentes según el search_type.

yfinance_get_top

Obtén las entidades financieras mejor clasificadas dentro de un sector de mercado.

Devuelve: Matriz JSON de las principales entidades con métricas relevantes.

Sectores admitidos

Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities

yfinance_get_price_history

Obtén datos históricos de precios y, opcionalmente, genera gráficos de análisis técnico.

Tipos de gráficos:

Devuelve:

• Sin chart_type: Tabla Markdown con columnas de Fecha, Apertura, Máximo, Mínimo, Cierre, Volumen, Dividendos y Desdoblamientos de acciones.

• Con chart_type: Imagen WebP codificada en Base64 para un uso eficiente de tokens.

yfinance_get_financials

Obtén estados financieros (estado de resultados, balance general y flujo de caja) con datos históricos.

Devuelve: Objeto JSON con datos de estado de resultados, balance general y flujo de caja para cada período de informe.

• Campos del estado de resultados: EBIT, Ingreso neto, Provisión para impuestos, Ingreso antes de impuestos, Gastos por intereses, Ingresos totales, Ingresos operativos, EBITDA, Ingreso normalizado

• Campos del balance general: Patrimonio de los accionistas, Deuda total, Efectivo y equivalentes de efectivo, Capital invertido, Deuda neta, Activos totales, Pasivos totales menos interés minoritario, Activos tangibles netos, Valor contable tangible

• Campos del flujo de caja: Flujo de caja operativo, Flujo de caja libre, Gastos de capital, Ingreso neto de operaciones continuas, Depreciación y amortización, Cambio en el capital de trabajo, Dividendos en efectivo pagados

Uso

Vía uv (recomendado)

1. Instala uv

2. Añade lo siguiente a la configuración de tu cliente MCP:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uvx",
 "args": ["yfmcp@latest"]
 }
 }
}

Vía Docker

{
 "mcpServers": {
 "yfmcp": {
 "command": "docker",
 "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
 }
 }
}

Desde el código fuente

1. Clona el repositorio e instala las dependencias:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync

2. Añade lo siguiente a la configuración de tu cliente MCP:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uv",
 "args": [
 "run",
 "--directory",
 "/path/to/yfinance-mcp",
 "yfmcp"
 ]
 }
 }
}

Reemplaza /path/to/yfinance-mcp con la ruta real a tu repositorio clonado.

Desarrollo

Requisitos previos

• Python ≥ 3.12

• Gestor de paquetes uv

Configuración

uv sync --extra dev

Lint y formato

uv run ruff check .
uv run ruff format .

Verificación de tipos

uv run ty check src tests

Prueba

uv run pytest -v -s --cov=src tests

Chatbot de demostración

Consulta el chatbot de demostración en su repositorio dedicado: yfinance-mcp-demo

Colaboradores

Hecho con contrib.rocks.

Licencia

Este proyecto está bajo la Licencia MIT.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• yfinance_get_financialsA
• yfinance_get_holdersA
• yfinance_get_option_chainA
• yfinance_get_option_datesA
• yfinance_get_price_historyA
• yfinance_get_ticker_infoA
• yfinance_get_ticker_newsA
• yfinance_get_topA