Alphavantage MCP

🚀 Alpha Vantage MCP 服務器

本項目是一個用於訪問 Alpha Vantage 股票和金融數據的 Model Context Protocol (MCP) 服務器，能幫助用戶便捷獲取各類金融數據。

✨ 主要特性

• 完整支持 Alpha Vantage API 的所有端點，涵蓋股票、經濟指標、技術指標、外匯、加密貨幣和大宗商品等領域。
• 為減少上下文窗口的使用，將某些端點整合到同一工具下，如技術指標、外匯、大宗商品和加密貨幣。

📚 詳細文檔

API 組織

為提供更高效的體驗並顯著減少上下文窗口的使用，對 API 進行了如下組織：

• 技術指標：整合為 5 個統一的端點（移動平均線、動量、波動率、成交量、週期），帶有類型參數。
• 大宗商品：通過 commodity_type 參數統一到一個端點。
• 外匯：時間序列端點通過 series_type 參數整合。
• 加密貨幣：時間序列端點通過 series_type 參數整合。

這種組織方式在保持所有功能的同時，大幅減少了所需的工具數量。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴項：npm install。
3. 複製示例環境文件：cp .env.example .env。
4. 編輯 .env 文件並在其中添加您的 Alpha Vantage API 密鑰。
   • 在 Alpha Vantage 免費獲取 API 密鑰。
5. 構建項目：npm run build。

💻 使用示例

連接到 Claude 客戶端

此 MCP 服務器可與任何兼容的客戶端（如 Claude）一起使用。

示例查詢：

• "獲取 MSFT 的股票報價"
• "顯示 AAPL 的 RSI 動量指標，週期為 14 天"
• "USD 和 EUR 的匯率是多少？"
• "獲取比特幣 USD 每月的價格數據"
• "顯示原油在過去一個季度的價格"

📄 許可證

本項目採用 MIT 許可證。