Us Stock MCP Server

🚀 美國股票數據 MCP 服務

本服務是一個專為訪問和更新美國股票歷史價格數據設計的模型上下文協議（MCP）服務器，能夠實現本地數據的快速存儲與訪問，還支持從雅虎財經自動更新數據，為用戶提供便捷、安全的數據服務。

✨ 主要特性

• 本地數據存儲：以 CSV 格式本地存儲股票數據，實現快速訪問。
• 自動更新：支持從雅虎財經自動獲取股票數據。
• 安全寫入數據：使用臨時文件確保數據寫入的原子性和安全性。
• 靈活的時間範圍：可自定義數據更新的起始日期。

📦 安裝指南

1. 確保已安裝 Python 3.x。
2. 克隆此倉庫。
3. 安裝依賴項：

pip install -r requirements.txt

💻 使用示例

基礎用法

1. 啟動服務器

python server.py

默認數據存儲路徑為啟動後：~/Library/Application Support/us-market-data/data。您可以通過 US_STOCK_DATA_DIR 環境變量自定義數據存儲路徑。

2. 可用功能

MCP 工具

• 獲取本地股票數據 (get_local_stock_data)

  • 功能：檢索本地股票歷史數據。
  • 參數：
    • symbol：股票代碼，例如 'AAPL'、'MSFT'。

• 更新股票數據 (update_stock_data)

  • 功能：更新股票數據。
  • 參數：
    • symbol：股票代碼，例如 'AAPL'、'MSFT'。
    • start_date：起始日期，格式為 YYYY-MM-DD，默認為 2015-01-01。

MCP 資源

• 資源 URI：usstock://{symbol}/historical
  • 功能：提供本地美國股票歷史價格數據。
  • 參數：
    • symbol：股票代碼。

📚 詳細文檔

數據格式

存儲的股票數據包含以下字段：

依賴項

• mcp：MCP 協議實現
• pandas：數據處理和分析
• yfinance：雅虎財經數據獲取
• pydantic：數據驗證和設置管理

🔧 技術細節

• 更新過程中會自動處理重複數據，保留最新記錄。
• 實現了 5 秒的延遲以避免頻繁的 API 請求。
• 所有數據操作均包含錯誤處理，確保服務穩定性。

⚠️ 重要提示

本服務在更新數據時會自動處理重複數據，保留最新記錄。同時，為避免頻繁的 API 請求，實現了 5 秒的延遲。

💡 使用建議

您可以通過 US_STOCK_DATA_DIR 環境變量自定義數據存儲路徑，以滿足不同的使用需求。