Herramienta YFinance Trader MCP para Claude Desktop

Una herramienta MCP (Model Context Protocol) que proporciona datos del mercado de valores y capacidades comerciales utilizando la biblioteca yfinance, específicamente adaptada para Claude Desktop.

Crédito : Este proyecto se inspiró en mcp-stocks de Luigi Ajah, una implementación similar para Cursor. Esta adaptación modifica el concepto original para que funcione con Claude Desktop.

Tutorial

Para obtener una guía detallada sobre la configuración y el uso de esta herramienta, consulte nuestro tutorial de Medium: Tutorial: Cómo usar Claude Desktop con la herramienta YFinance Trader MCP 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
Función de búsqueda de símbolos
Recomendaciones de los analistas
Seguimiento de transacciones con información privilegiada

Configuración

Asegúrese de tener instalado Python 3.10 o superior
Instalar dependencias:

pip install -r requirements.txt

Integración con Claude Desktop

Configure los ajustes de MCP en Claude Desktop agregando lo siguiente a su configuración de MCP:

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

Reemplace la ruta con la ruta completa a su archivo main.py
Reinicie Claude Desktop si es necesario

Herramientas disponibles

1. obtener_cotización_de_acciones

Obtenga información sobre cotizaciones 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. obtener_visión_general_de_la_empresa

Obtenga 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. obtener_series_temporales_diarias

Obtenga 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. símbolo_de_búsqueda

Búsqueda de acciones y otros valores:

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

5. obtener_recomendaciones

Obtenga 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. obtener transacciones internas

Obtenga información sobre tráfico 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 muestra

Puedes hacerle a Claude Desktop preguntas como:

"¿Cuál es el precio actual de las acciones y el cambio diario de AAPL?"
"¿Puede darme una descripción general de la empresa Microsoft (MSFT)?"
"Muéstrame los datos históricos de precios de Tesla (TSLA) de los últimos 3 meses".
"Buscar acciones relacionadas con 'NVDA'."
"¿Cuáles son las recomendaciones de los analistas para Amazon (AMZN)?"
"¿Ha habido alguna transacción interna reciente en Google (GOOGL)?"

Soporte para criptomonedas

Hay datos limitados sobre criptomonedas disponibles mediante formatos de ticker especiales:

BTC-USD por 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:

Asegúrese de que el servidor esté ejecutándose: debería ver el resultado cuando inicie el script
Verifique que la ruta en su configuración sea correcta y absoluta
Asegúrese de que Python 3.10+ esté en la RUTA de su sistema
Compruebe que todas las dependencias estén instaladas
Intente reiniciar Claude Desktop
Verifique 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 modificado y formatos de respuesta
Enfoque de configuración actualizado

Licencia

Licencia MIT

YFinance Trader MCP Tool

Integrations