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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Proporciona datos del mercado de valores y capacidades comerciales utilizando la biblioteca yfinance

Related MCP Servers

StockScreen MCP Server
twolven
-
security
A
license
-
quality
Provides comprehensive stock screening capabilities through Yahoo Finance. Enables LLMs to screen stocks based on technical, fundamental, and options criteria, with support for watchlist management and result storage.
Last updated -
32
MIT License
Finance MCP Server
dino65-dev
-
security
A
license
-
quality
Provides real-time financial data from Yahoo Finance to Large Language Models through the Model Context Protocol, enabling AI models to access stock prices, historical data, and company information.
Last updated -
MIT License
Yahoo Finance MCP Server
16Coffee
A
security
A
license
A
quality
A Model Context Protocol server providing comprehensive financial data from Yahoo Finance, allowing users to retrieve detailed stock information, financial statements, options data, and market news.
Last updated -
34
MIT License
Yahoo Finance MCP Server
leo-ye0
-
security
F
license
-
quality
A comprehensive financial data analysis server providing Yahoo Finance data for stocks, cryptocurrencies, technical analysis, portfolio management, and economic indicators through a clean interface.
Last updated -

View all related MCP servers

YFinance Trader MCP Tool