Herramienta Yfinance Trader Mcp para Claude Desktop

¿Qué es YFinance-Trader-MCP-ClaudeDesktop?

YFinance-Trader-MCP-ClaudeDesktop es una herramienta poderosa diseñada para entusiastas del mercado de valores y traders. Utiliza la biblioteca yfinance para proporcionar datos del mercado de valores en tiempo real y capacidades de trading. Esta herramienta está específicamente adaptada para Claude Desktop, lo que la hace fácil de usar y eficiente para aquellos que buscan analizar y comerciar acciones sin problemas.

Características de YFinance-Trader-MCP-ClaudeDesktop

• Acceso a Datos en Tiempo Real: Obtén acceso instantáneo a datos del mercado de valores, incluyendo precios, datos históricos y métricas financieras.
• Capacidades de Trading: Ejecuta operaciones directamente a través de la aplicación, permitiendo una toma de decisiones rápida basada en datos en tiempo real.
• Interfaz Amigable: Diseñada para ser fácil de usar, la interfaz es intuitiva, lo que la hace accesible tanto para traders novatos como experimentados.
• Alertas Personalizables: Configura alertas para movimientos específicos de acciones o cambios de precios para mantenerte informado sobre las condiciones del mercado.
• Análisis Integral: Analiza el rendimiento de las acciones con varias métricas y visualizaciones para tomar decisiones de trading informadas.

Cómo Usar YFinance-Trader-MCP-ClaudeDesktop

1. Instalación: Descarga e instala la aplicación YFinance-Trader-MCP-ClaudeDesktop desde el repositorio oficial.
2. Configuración: Configura la configuración de tu cuenta y conéctate a tu plataforma de trading.
3. Explora las Características: Familiarízate con el panel de control, donde puedes ver datos de acciones, ejecutar operaciones y configurar alertas.
4. Comienza a Operar: Utiliza los datos en tiempo real para tomar decisiones de trading informadas y ejecuta operaciones directamente desde la aplicación.
5. Monitorea el Rendimiento: Mantén un seguimiento de tus inversiones y analiza el rendimiento utilizando las herramientas de análisis integradas.

Preguntas Frecuentes

P: ¿Es YFinance-Trader-MCP-ClaudeDesktop gratuito?

R: Sí, la herramienta es de código abierto y está disponible de forma gratuita. Puedes descargarla desde el repositorio de GitHub.

P: ¿Qué plataformas soporta?

R: YFinance-Trader-MCP-ClaudeDesktop está diseñado específicamente para Claude Desktop, asegurando compatibilidad y rendimiento óptimo.

P: ¿Puedo personalizar las alertas?

R: Sí, los usuarios pueden configurar alertas personalizables para movimientos específicos de acciones o cambios de precios para mantenerse actualizados.

P: ¿Con qué frecuencia se actualizan los datos de acciones?

R: La aplicación proporciona datos en tiempo real, asegurando que los usuarios tengan la información más actual disponible para decisiones de trading.

P: ¿Dónde puedo encontrar soporte o reportar problemas?

R: El soporte y la reportación de problemas se pueden realizar a través del rastreador de problemas del repositorio de GitHub, donde también puedes encontrar discusiones comunitarias y actualizaciones.

YFinance Trader MCP Tool for Claude Desktop

An MCP (Model Context Protocol) tool that provides stock market data and trading capabilities using the yfinance library, specifically adapted for Claude Desktop.

Credit: This project was inspired by mcp-stocks by Luigi Ajah, which is a similar implementation for Cursor. This adaptation modifies the original concept to work with Claude Desktop.

Tutorial

For a detailed guide on setting up and using this tool, check out our Medium tutorial: Tutorial: Using Claude Desktop with YFinance Trader MCP Tool to Access Real-Time Stock Market Data

Features

• Real-time stock quotes
• Company information and financial metrics
• Historical price data
• Symbol search functionality
• Analyst recommendations
• Insider transaction tracking

Setup

1. Ensure you have Python 3.10 or higher installed

2. Install dependencies:

pip install -r requirements.txt

Integration with Claude Desktop

1. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:

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

2. Replace the path with the full path to your main.py file
3. Restart Claude Desktop if needed

Available Tools

1. get_stock_quote

Get real-time stock quote information:

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

2. get_company_overview

Get company information and key metrics:

{
    "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

Get historical daily price data:

{
    "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

Search for stocks and other securities:

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

5. get_recommendations

Get analyst recommendations for a stock:

{
    "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

Get insider trading information:

{
    "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
    ]
}

Sample Queries

You can ask Claude Desktop questions like:

• "What is the current stock price and daily change for AAPL?"
• "Can you give me a company overview for Microsoft (MSFT)?"
• "Show me the historical price data for Tesla (TSLA) over the last 3 months."
• "Search for stocks related to 'NVDA'."
• "What are the analyst recommendations for Amazon (AMZN)?"
• "Have there been any recent insider transactions for Google (GOOGL)?"

Cryptocurrency Support

Limited cryptocurrency data is available using special ticker formats:

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

Error Handling

All tools include proper error handling and will return an error message if something goes wrong:

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

Troubleshooting

If the MCP server is not working in Claude Desktop:

1. Make sure the server is running - you should see output when you start the script
2. Verify the path in your settings is correct and absolute
3. Make sure Python 3.10+ is in your system PATH
4. Check that all dependencies are installed
5. Try restarting Claude Desktop
6. Check logs for any error messages

Differences from the original mcp-stocks project

• Uses the MCP library directly instead of FastAPI
• Adapted for Claude Desktop instead of Cursor
• Modified error handling and response formats
• Updated configuration approach

License

MIT License