Protocolo de contexto del modelo (MCP) de Yahoo Finance para LLaMA 3.2 3B

Este repositorio contiene una implementación del Protocolo de Contexto de Modelo (MCP) que integra la API de Yahoo Finance con LLaMA 3.2 3B. El MCP permite al modelo recuperar datos financieros, información bursátil y noticias del mercado en tiempo real, conservando todas las funciones habituales de LLaMA.

Características

• Obtenga precios de acciones en tiempo real directamente en LLaMA 3.2 3B
• Recupere información detallada de la empresa (sector, industria, capitalización de mercado, etc.)
• Obtenga datos históricos de acciones con períodos de tiempo e intervalos personalizables
• Obtenga los últimos titulares de noticias del mercado
• Mejora sin problemas las capacidades de LLaMA sin interferir con consultas no financieras

Requisitos

• Python 3.8+
• Ollama - Para ejecutar LLaMA 3.2 3B localmente
• Modelo LLaMA 3.2 3B arrastrado por Ollama
• Paquetes de Python:
  • llama
  • yfinanzas
  • solicitudes
  • pandas

Instalación

1. Instale Ollama desde https://ollama.ai/
2. Extraiga el modelo LLaMA 3.2 3B usando Ollama:
   ollama pull llama3.2:3b
3. Clonar este repositorio:
   git clone <repository-url> cd mcp_yahoo_finance
4. Instale las dependencias de Python necesarias:
   pip install -r requirements.txt

Uso

Ejecución del MCP con la integración de Ollama

Para utilizar el MCP de Yahoo Finance con LLaMA 3.2 3B a través de Ollama:

Esto iniciará una sesión interactiva donde podrás:

• Haga preguntas financieras que se enriquecerán con los datos de Yahoo Finance
• Haga cualquier otra pregunta que será atendida normalmente por LLaMA 3.2 3B

Consultas de ejemplo

Consultas financieras (mejoradas con datos de Yahoo Finance)

• "¿Cuál es el precio actual de las acciones de Apple?"
• Cuéntame sobre Tesla como empresa.
• "¿Cómo se han comportado las acciones de Microsoft durante el último mes?"
• "¿Cuáles son los últimos titulares de las noticias del mercado?"
• "¿Cuál es el máximo de 52 semanas para Amazon?"
• ¿En qué sector opera Nvidia?
• "¿Cómo se ha comportado el S&P 500 este año?"

Consultas no financieras (atendidas normalmente por LLaMA)

• "¿Cuál es la capital de Francia?"
• "Explica la computación cuántica"
• "Escribe un poema sobre el otoño"
• "¿Qué es el teorema de Pitágoras?"

Usando un modelo LLaMA diferente

Puede especificar un modelo diferente con el parámetro --model :

Cómo funciona

1. El MCP analiza cada consulta del usuario para determinar si está relacionada con las finanzas.
2. Para consultas financieras:
   • Identifica la función financiera relevante a llamar (precio, información, historial, noticias)
   • Llama a la API de Yahoo Finance a través del MCP
   • Formatea los datos en tiempo real y los envía a LLaMA 3.2 3B como contexto
   • LLaMA 3.2 3B proporciona una respuesta natural incorporando los datos financieros
3. Para consultas no financieras las pasa directamente a LLaMA 3.2 3B sin modificaciones

Este enfoque mejora sin problemas las capacidades de LLaMA con datos financieros en tiempo real y al mismo tiempo conserva toda su funcionalidad original.

Uso avanzado

Funciones API directas

Si desea utilizar las funciones MCP de Yahoo Finance directamente en su código:

Solución de problemas

• "Error al conectar con Ollama" : Asegúrese de que Ollama esté instalado y ejecutándose
• Empresa no encontrada : intente utilizar el símbolo oficial en lugar del nombre de la empresa
• Modelo LLaMA 3.2 3B no encontrado : Ejecute ollama pull llama3.2:3b para descargar el modelo

Expresiones de gratitud

Este proyecto utiliza la biblioteca yfinance para recuperar datos de Yahoo Finance y Ollama para ejecutar LLaMA 3.2 3B localmente.