Stockmcp

🚀 雅虎財經模型上下文協議（MCP）用於LLaMA 3.2 3B

本項目將Yahoo Finance API與LLaMA 3.2 3B集成，通過模型上下文協議（MCP），讓模型在保留原有功能的同時，還能獲取即時金融數據、股票信息和市場新聞，為金融相關的問答提供有力支持。

✨ 主要特性

• 即時股價獲取：可在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獲取最新信息，並將其返回給模型。

🔧 技術細節

MCP作為適配器，允許LLaMA訪問外部數據源（Yahoo Finance）。它通過攔截和處理特定格式的查詢來實現這一點。當用戶提問需要即時數據時，MCP會調用Yahoo Finance API獲取最新信息，並將其返回給模型。

📚 詳細文檔

故障排除

問題：服務未啟動

• 檢查是否已正確安裝並運行Ollama。
• 確保模型已正確拉取。

問題：無法連接到Ollama

• 檢查Ollama服務是否正在運行。
• 確保防火牆允許相關端口的訪問。

問題：API調用失敗

• 檢查網絡連接。
• 確保Yahoo Finance API密鑰有效。

注意事項

• 該工具僅用於研究和教育目的。
• 使用前請閱讀Yahoo Finance的使用條款和服務協議。

貢獻者

感謝所有為該項目做出貢獻的人！