MCP Yahoo Finanzas

Un servidor de Protocolo de Contexto de Modelo (MCP) para la interacción con Yahoo Finanzas. Este servidor proporciona herramientas para obtener precios, información de la empresa y generar visualizaciones financieras.

Este proyecto es una bifurcación y extensión de maxscheijen/mcp-yahoo-finance , con capacidades de visualización agregadas.

Características

Datos financieros : obtenga precios de acciones actuales, precios históricos, dividendos, estados de resultados y más
Análisis visual : genere hermosas visualizaciones para el sentimiento del mercado, el seguimiento de la cartera y el análisis técnico.
Fácil integración : funciona con Claude Desktop, VS Code, Cursor y otros clientes MCP

Instrucciones de configuración

1. Clonar el repositorio

Clone este repositorio en su máquina local:

git clone https://github.com/leoncuhk/mcp-yahoo-finance.git
cd mcp-yahoo-finance

2. Instalar dependencias

Instale las dependencias necesarias usando pip:

pip install -r requirements.txt

Si falta el archivo requirements.txt, puedes instalar las dependencias directamente:

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

3. Configurar el cliente MCP

Escritorio de Claude

Agregue esto a su claude_desktop_config.json (créelo si no existe):

macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas : %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

También puedes usar Docker:

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "IMAGE"]
        }
    }
}

VSCode

Agregue esto a su .vscode/mcp.json :

{
    "servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

Cursor

Agregue esto a su configuración de Cursor MCP:

{
    "mcp-servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

4. Reinicie su cliente MCP

Después de la configuración, reinicie Claude Desktop o su cliente MCP preferido para cargar el servidor.

Herramientas disponibles

Datos financieros básicos

get_current_stock_price : Obtener el precio actual de las acciones de un símbolo
get_stock_price_by_date : Obtener el precio de las acciones para una fecha específica
get_stock_price_date_range : Obtener precios de acciones para un rango de fechas
get_historical_stock_prices : Obtenga datos históricos de acciones con períodos personalizables
get_dividends : Obtener información de dividendos de una acción
get_income_statement : Obtener datos del estado de resultados
get_cashflow : Obtener datos del estado de flujo de caja
get_earning_dates : Obtener información sobre las fechas de ganancias
get_news : Obtenga noticias recientes sobre una acción

Herramientas de visualización

generate_market_dashboard : Crea un panel de sentimiento del mercado con rendimiento del índice en tiempo real
generate_portfolio_report : Generar un informe de seguimiento del rendimiento de la cartera
generate_stock_technical_analysis : Crea un informe de análisis técnico para una acción

Ejemplos de visualización

Panel de sentimiento del mercado

Seguimiento de cartera

Análisis técnico de acciones

Ejemplos de indicaciones

A continuación se muestran algunos ejemplos de indicaciones para probar con Claude:

Datos financieros básicos

"¿Cuál es el precio actual de las acciones de Apple?"
"¿Cuál es la diferencia en el precio de las acciones de Apple y Google?"
¿Cuánto varió el precio de las acciones de Apple entre el 01/01/2025 y el 31/03/2025?

Solicitudes de visualización

"Generar un panel de sentimiento del mercado que muestre el rendimiento de los principales índices".
Cree un informe de seguimiento de cartera para las acciones tecnológicas AAPL, MSFT, GOOGL, AMZN y NVDA.
"Muéstreme un gráfico de análisis técnico de las acciones de Tesla con promedios móviles y niveles de soporte/resistencia".
Genere un panel de sentimiento del mercado con S&P 500, Dow Jones y NASDAQ.
"¿Puede crear un informe de cartera para mis acciones de energía: XOM, CVX, BP, COP y SLB?"
Necesito un análisis técnico detallado de las acciones de NVDA que muestre patrones de RSI y volumen.

Pruebas

Para probar las capacidades de visualización:

cd tests
python test_visualization.py

Esto generará imágenes de visualización de ejemplo en el directorio examples .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Proyecto original de Max Scheijen
Ampliado con capacidades de visualización inspiradas en tooyipjee

MCP Yahoo Finance

Integrations