Yahoo Finance

Yahoo Finance MCP Server

Este es un servidor del Model Context Protocol (MCP) que proporciona datos financieros completos de Yahoo Finance. Te permite recuperar información detallada sobre acciones, incluidos precios históricos, información de la empresa, estados financieros, datos de opciones y noticias del mercado.

Demo

Herramientas MCP

El servidor expone las siguientes herramientas a través del Model Context Protocol:

Información de Acciones

Herramienta	Descripción
get_historical_stock_prices	Obtén datos históricos OHLCV de una acción con período e intervalo personalizables
get_stock_info	Obtén datos completos de la acción, incluidos precio, métricas y detalles de la empresa
get_yahoo_finance_news	Obtén los artículos de noticias más recientes de una acción
get_stock_actions	Obtén el historial de dividendos y divisiones de acciones

Estados Financieros

Herramienta	Descripción
get_financial_statement	Obtén el estado de resultados, balance general o estado de flujo de efectivo (anual/trimestral)
get_holder_info	Obtén los principales tenedores, tenedores institucionales, fondos mutuos o transacciones de información privilegiada

Datos de Opciones

Herramienta	Descripción
get_option_expiration_dates	Obtén las fechas de vencimiento de opciones disponibles
get_option_chain	Obtén la cadena de opciones para una fecha de vencimiento y tipo específicos (calls/puts)

Información de Analistas

Herramienta	Descripción
get_recommendations	Obtén recomendaciones de analistas o historial de mejoras/rebajas

Casos de Uso en el Mundo Real

Con este servidor MCP, puedes usar Claude para:

Análisis de Acciones

• Análisis de Precios: "Muéstrame los precios históricos de las acciones de AAPL durante los últimos 6 meses con intervalos diarios."
• Salud Financiera: "Obtén el balance general trimestral de Microsoft."
• Métricas de Rendimiento: "¿Cuáles son las métricas financieras clave de Tesla según la información de la acción?"
• Análisis de Tendencias: "Compara los estados de resultados trimestrales de Amazon y Google."
• Análisis de Flujo de Efectivo: "Muéstrame el estado de flujo de efectivo anual de NVIDIA."

Investigación de Mercado

• Análisis de Noticias: "Obtén los artículos de noticias más recientes sobre Meta Platforms."
• Actividad Institucional: "Muéstrame los tenedores institucionales de las acciones de Apple."
• Información Privilegiada: "¿Cuáles son las transacciones recientes de información privilegiada de Tesla?"
• Análisis de Opciones: "Obtén la cadena de opciones de SPY con fecha de vencimiento 2024-06-21 para calls."
• Cobertura de Analistas: "¿Cuáles son las recomendaciones de los analistas para Amazon durante los últimos 3 meses?"

Investigación de Inversiones

• "Crea un análisis completo de la salud financiera de Microsoft utilizando sus últimos estados financieros trimestrales."
• "Compara el historial de dividendos y las divisiones de acciones de Coca-Cola y PepsiCo."
• "Analiza los cambios en la propiedad institucional de Tesla durante el último año."
• "Genera un informe sobre la actividad del mercado de opciones para las acciones de Apple con vencimiento en 30 días."
• "Resume las últimas mejoras y rebajas de analistas en el sector tecnológico durante los últimos 6 meses."

Requisitos

• Python 3.11 o superior
• Dependencias como se enumeran en pyproject.toml, incluyendo:
  • mcp
  • yfinance
  • pandas
  • pydantic
  • y otros paquetes para el procesamiento de datos

Configuración

1. Clona este repositorio:

   git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
   cd yahoo-finance-mcp
   

2. Crea y activa un entorno virtual e instala las dependencias:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   uv pip install -e .
   

Uso

Modo de Desarrollo

Puedes probar el servidor con MCP Inspector ejecutando:

uv run server.py

Esto iniciará el servidor y te permitirá probar las herramientas disponibles.

Integración con Claude for Desktop

Para integrar este servidor con Claude for Desktop:

1. Instala Claude for Desktop en tu máquina local.

2. Instala VS Code en tu máquina local. Luego ejecuta el siguiente comando para abrir el archivo claude_desktop_config.json:

   • MacOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: code $env:AppData\Claude\claude_desktop_config.json

3. Edita el archivo de configuración de Claude for Desktop, ubicado en:

   • macOS:

     {
       "mcpServers": {
         "yfinance": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • Windows:

     {
       "mcpServers": {
         "yfinance": {
           "command": "uv",
           "args": [
             "--directory",
             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • Nota: Es posible que debas poner la ruta completa al ejecutable de uv en el campo de comando. Puedes obtenerla ejecutando which uv en MacOS/Linux o where uv en Windows.

4. Reinicia Claude for Desktop

Licencia

MIT