Stock MCP Server

🚀 印度股票分析中間件（MCP）服務器文檔

印度股票分析中間件（MCP）服務器是一款專門用於處理和分析印度股票市場數據的工具。它支持從MongoDB數據庫獲取股票數據，還能通過Alpha Vantage API獲取即時市場數據，為股票分析工作提供了有力支持。

🚀 快速開始

印度股票分析中間件（MCP）服務器可幫助用戶處理和分析印度股票市場數據，通過與MongoDB數據庫和Alpha Vantage API集成，實現數據的存儲、獲取與分析。

✨ 主要特性

• 數據存儲：支持從MongoDB中讀取和寫入股票數據，方便數據的管理和維護。
• 即時數據獲取：藉助Alpha Vantage API獲取即時股票價格、技術指標等數據，確保分析數據的及時性。
• 數據分析：提供多種分析工具，如技術指標計算、市場趨勢分析等，助力用戶深入瞭解股票市場。
• API管理：內置對Alpha Vantage免費層API的管理和優化，有效應對API調用限制。

📦 安裝指南

環境變量

需在項目的.env文件中定義以下環境變量：

MongoDB配置

• MONGODB_URI：MongoDB連接字符串（默認值：mongodb://localhost:27017）
• MONGODB_DB_NAME：數據庫名稱（默認值：stock_data）
• MONGODB_HOLDINGS_COLLECTION：持股集合名稱（默認值：holdings）
• MONGODB_FINANCIALS_COLLECTION：財務數據集合名稱（默認值：detailed_financials）
• MONGODB_KNOWLEDGE_GRAPH_COLLECTION：知識圖譜集合名稱（默認值：stock_knowledge_graph）

Alpha Vantage API配置

• ALPHA_VANTAGE_API_KEY：你的Alpha Vantage API密鑰
• ALPHA_VANTAGE_BASE_URL：Alpha Vantage API URL（默認值：https://www.alphavantage.co/query）
• ALPHA_VANTAGE_RATE_LIMIT_MINUTE：每分鐘允許的API調用次數（默認值：5）
• ALPHA_VANTAGE_RATE_LIMIT_DAY：每天允許的API調用次數（默認值：500）
• ALPHA_VANTAGE_DEFAULT_EXCHANGE：默認交易所（用於印度股票，默認值：NSE）

MCP服務器配置

• MCP_SERVER_NAME：服務器名稱（默認值：stock-analysis-mcp）
• MCP_SERVER_VERSION：服務器版本（默認值：0.1.0）

日誌配置

• LOG_LEVEL：日誌級別（默認值：INFO）
• LOG_FORMAT：日誌消息格式

緩存設置

• CACHE_ENABLED：啟用緩存（默認值：True）
• CACHE_TTL：緩存過期時間，以秒為單位（默認值：3600）

🔧 技術細節

Alpha Vantage免費層支持

該服務器針對Alpha Vantage的免費層API進行了優化，具體限制如下：

• 每分鐘5次API調用限制
• 每天500次API調用限制 支持以下基本端點：
  • GLOBAL_QUOTE：當前價格信息
  • TIME_SERIES_DAILY：日度價格歷史數據
  • OVERVIEW：公司信息
  • SYMBOL_SEARCH：查找印度股票符號
  • 基本技術指標（SMA、RSI）

API管理

該服務器集成了對Alpha Vantage API的複雜管理，以在免費層限制內有效運行：

速率限制跟蹤

• 維護每個分鐘窗口內的全局API調用計數器
• 自動檢測和處理來自Alpha Vantage的速率限制響應
• 提供通過get_alpha_vantage_status工具獲取API狀態信息

智能調用管理

• 預檢檢查：在進行API調用之前，工具會檢查是否會超出速率限制。
• 成本意識處理：每個API函數都有一個分配的“成本”來跟蹤其影響。
• 優雅降級：當達到速率限制時，工具提供靜態數據或教育內容。
• 目標調用：技術分析可以配置為僅檢索特定指標。

回退機制

當達到速率限制時，系統會提供替代內容：

• 靜態市場數據用於 trending股票
• 教育性內容關於技術指標
• 可用的歷史數據
• 關於何時再次嘗試的明確消息

💻 使用示例

基礎用法

以下是Claude高效使用API的方式：

1. 首先檢查API狀態：

   • "讓我先檢查Alpha Vantage API的狀態再繼續"
   • 這有助於規劃在5次調用限制內可以進行哪些調用。

2. 使用優化工具：

   • "我會使用優化的技術分析來獲取僅SMA指標"
   • 這樣可以只為請求的信息做出必要的API調用。

3. 批量相似請求：

   • "讓我先收集所有股票符號，然後一起查詢它們"
   • 這樣可以減少不必要的API調用次數。

4. 使用緩存提高效率：

   • 利用緩存功能，避免重複獲取相同數據。
   • 設置合適的CACHE_TTL以保持數據新鮮度。

通過以上方法，可以最大化利用Alpha Vantage API，並確保在免費層限制內高效地進行股票數據分析。