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

Related MCP server: Yahoo Finance MCP Server

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

1. "¿Cuál es el precio actual de las acciones de Apple?"

2. "¿Cuál es la diferencia en el precio de las acciones de Apple y Google?"

3. ¿Cuánto varió el precio de las acciones de Apple entre el 01/01/2025 y el 31/03/2025?

Solicitudes de visualización

1. "Generar un panel de sentimiento del mercado que muestre el rendimiento de los principales índices".

2. Cree un informe de seguimiento de cartera para las acciones tecnológicas AAPL, MSFT, GOOGL, AMZN y NVDA.

3. "Muéstreme un gráfico de análisis técnico de las acciones de Tesla con promedios móviles y niveles de soporte/resistencia".

4. Genere un panel de sentimiento del mercado con S&P 500, Dow Jones y NASDAQ.

5. "¿Puede crear un informe de cartera para mis acciones de energía: XOM, CVX, BP, COP y SLB?"

6. 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