YFinance Trader

Herramienta MCP YFinance Trader para Claude Desktop

Una herramienta MCP (Protocolo de Contexto de Modelo) que proporciona datos del mercado de valores y capacidades de negociación utilizando la biblioteca yfinance, específicamente adaptada para Claude Desktop.

Crédito: Este proyecto fue inspirado por mcp-stocks de Luigi Ajah, que es una implementación similar para Cursor. Esta adaptación modifica el concepto original para funcionar con Claude Desktop.

Tutorial

Para una guía detallada sobre la configuración y el uso de esta herramienta, consulta nuestro tutorial en Medium: Tutorial: Uso de Claude Desktop con la Herramienta MCP YFinance Trader para Acceder a Datos del Mercado de Valores en Tiempo Real

Características

• Cotizaciones de acciones en tiempo real
• Información de la empresa y métricas financieras
• Datos históricos de precios
• Funcionalidad de búsqueda de símbolos
• Recomendaciones de analistas
• Seguimiento de transacciones de información privilegiada

Configuración

1. Asegúrate de tener Python 3.10 o superior instalado

2. Instala las dependencias:

pip install -r requirements.txt

Integración con Claude Desktop

1. Configura los ajustes de MCP en Claude Desktop añadiendo lo siguiente a tu configuración de MCP:

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

2. Reemplaza la ruta con la ruta completa a tu archivo main.py
3. Reinicia Claude Desktop si es necesario

Herramientas Disponibles

1. get_stock_quote

Obtén información de cotización de acciones en tiempo real:

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. get_company_overview

Obtén información de la empresa y métricas clave:

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

Obtén datos históricos de precios diarios:

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 151.75,
            "volume": 12345678
        }
        // ... more data points
    ]
}

4. search_symbol

Busca acciones y otros valores:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5. get_recommendations

Obtén recomendaciones de analistas para una acción:

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... more periods
    ]
}

6. get_insider_transactions

Obtén información sobre operaciones de información privilegiada:

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

Consultas de Ejemplo

Puedes hacer preguntas a Claude Desktop como:

• "¿Cuál es el precio actual de la acción y el cambio diario de AAPL?"
• "¿Puedes darme una visión general de la empresa Microsoft (MSFT)?"
• "Muéstrame los datos históricos de precios de Tesla (TSLA) en los últimos 3 meses."
• "Busca acciones relacionadas con 'NVDA'."
• "¿Cuáles son las recomendaciones de los analistas para Amazon (AMZN)?"
• "¿Ha habido transacciones recientes de información privilegiada para Google (GOOGL)?"

Soporte de Criptomonedas

Hay datos limitados de criptomonedas disponibles utilizando formatos de ticker especiales:

• BTC-USD para Bitcoin
• ETH-USD para Ethereum
• DOGE-USD para Dogecoin

Manejo de Errores

Todas las herramientas incluyen un manejo de errores adecuado y devolverán un mensaje de error si algo sale mal:

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

Solución de Problemas

Si el servidor MCP no funciona en Claude Desktop:

1. Asegúrate de que el servidor esté en ejecución: deberías ver resultados al iniciar el script
2. Verifica que la ruta en tu configuración sea correcta y absoluta
3. Asegúrate de que Python 3.10+ esté en la RUTA de tu sistema
4. Comprueba que todas las dependencias estén instaladas
5. Intenta reiniciar Claude Desktop
6. Revisa los registros para ver si hay mensajes de error

Diferencias con el proyecto original mcp-stocks

• Utiliza la biblioteca MCP directamente en lugar de FastAPI
• Adaptado para Claude Desktop en lugar de Cursor
• Manejo de errores y formatos de respuesta modificados
• Enfoque de configuración actualizado

Licencia

Licencia MIT