StockMCP

🚀 雅虎财经模型上下文协议（MCP）用于LLaMA 3.2 3B

此项目实现了一个雅虎财经模型上下文协议（MCP），并将其集成到LLaMA 3.2 3B中。通过该协议，模型能够直接获取实时金融数据、股票信息和市场新闻，同时保留了LLaMA原有的全部常规功能。

🚀 快速开始

本项目能够让LLaMA 3.2 3B模型获取雅虎财经的实时金融数据等信息。以下是使用前的准备和操作步骤。

✨ 主要特性

• 实时股票价格：可在LLaMA 3.2 3B中直接获取实时股票价格。
• 详细公司信息：能获取详细的公司信息，如行业、部门、市值等。
• 历史股票数据：支持检索历史股票数据，并可自定义时间段和间隔。
• 最新市场新闻：获取最新的市场新闻头条。
• 功能平滑增强：在不干扰非金融查询的情况下，平滑地增强LLaMA的功能。

📦 安装指南

先决条件

• Python 3.8+
• Ollama：用于在本地运行LLaMA 3.2 3B
• 已通过Ollama拉取的LLaMA 3.2 3B模型
• Python包：
  • ollama
  • yfinance
  • requests
  • pandas

安装步骤

1. 从https://ollama.ai/安装Ollama。
2. 使用Ollama拉取LLaMA 3.2 3B模型：

ollama pull llama3.2:3b

3. 克隆此仓库：

git clone <repository-url>
cd mcp_yahoo_finance

4. 安装所需的Python依赖项：

pip install -r requirements.txt

💻 使用示例

基础用法

要使用Yahoo Finance MCP与LLaMA 3.2 3B通过Ollama，可在终端运行以下命令：

python mcp_ollama_integration.py

运行该命令后，会启动一个交互式会话，您可以：

• 提问涉及财务的问题，这些问题将由 Yahoo Finance 数据丰富后回答
• 提问非财务相关问题

命令行选项

• -h, --help：显示帮助信息并退出。
• --port PORT：指定服务运行的端口，默认为8000。

高级用法

安装完成后，在一个终端运行：

python mcp_ollama_integration.py

然后在另一个终端中运行：

curl http://localhost:8000

📚 详细文档

工作原理

MCP作为适配器，允许LLaMA访问外部数据源（Yahoo Finance）。它通过拦截和处理特定格式的查询来实现这一点。当用户提问需要实时数据时，MCP会调用 Yahoo Finance API 获取最新信息，并将其返回给模型。

🔧 技术细节

故障排除

问题：服务未启动

• 检查是否已正确安装并运行Ollama。
• 确保模型已正确拉取。

问题：无法连接到 Ollama

• 检查Ollama服务是否正在运行。
• 确保防火墙允许相关端口的访问。

问题：API调用失败

• 检查网络连接。
• 确保Yahoo Finance API密钥有效。

📄 许可证

⚠️ 重要提示

该工具仅用于研究和教育目的。

💡 使用建议

使用前请阅读Yahoo Finance的使用条款和服务协议。

贡献者

感谢所有为该项目做出贡献的人！