Alphavantage MCP

🚀 AlphaVantage MCP 服務器

本項目是一個基於MCP（模型控制協議）框架的服務器，旨在無縫集成AlphaVantage金融數據API服務。藉助該服務器，開發者能夠更便捷地獲取各類金融數據。更多關於AlphaVantage的信息可查看此處。

🚀 快速開始

項目概述

AlphaVantage是一個強大的API服務，可提供即時和歷史金融市場數據，涵蓋股票市場數據、外匯數據、加密貨幣數據、技術指標以及基本面數據等。本項目將AlphaVantage的功能封裝到一個MCP服務中，極大地簡化了其與其他應用程序的集成過程。

安裝指南

先決條件

• Python 3.12
• pip 包管理器

安裝步驟

1. 克隆項目

git clone https://github.com/lifejwang11/alphavantage-mcp
cd alphavantage-mcp

2. 創建並激活虛擬環境（推薦）

python -m venv venv
source venv/bin/activate  # Unix/macOS
# 或者
.\venv\Scripts\activate  # Windows

3. 安裝依賴項

pip install -r requirements.txt

4. 配置環境變量

export ALPHAVANTAGE_API_KEY=your_api_key

5. 啟動服務器

python main.py

使用指南

1. 獲取AlphaVantage API密鑰
   • 訪問AlphaVantage網站
   • 註冊並獲取API密鑰
2. 配置API密鑰
   • 在環境變量中設置ALPHAVANTAGE_API_KEY
   • 或者在配置文件中進行配置
3. 服務調用
   • 通過MCP協議進行調用
   • 參考API文檔以獲取詳細接口規範說明

✨ 主要特性

此MCP服務器支持AlphaVantage的核心功能：

1. 股票市場數據
   • 即時報價
   • 歷史價格數據
   • 公司信息
2. 技術指標
   • 移動平均線
   • 相對強度指數（RSI）
   • MACD 等等
3. 基本面數據
   • 財務報表
   • 收益報告
   • 公司概覽

⚠️ 注意事項

⚠️ 重要提示

請參考AlphaVantage官方文檔瞭解API速率限制。

💡 使用建議

• 建議在生產環境中使用高級別API密鑰以獲得更高的速率限制。
• 安全處理API密鑰，切勿在公共代碼中洩露。

🤝 貢獻

歡迎提交問題和拉取請求以幫助改進項目。

📄 許可證

本項目採用MIT License。

版權 (c) 2025 lifejwang11

准許任何人獲得本軟件及其關聯的文檔文件（“軟件”）副本，可以在不受限制的情況下進行處理，包括但不限於以下權利：使用、複製、修改、合併、發佈、分發、授予子許可和/或出售軟件副本，並允許向他人提供該軟件，前提是以下條件：

本版權聲明和本許可聲明應包含在所有副本或大量軟件部分的副本中。

軟件按“原樣”提供，不做任何擔保，包括但不限於以下擔保：對商品性、特定用途適用性以及不侵權的明示或暗示保證。在因合同、侵權或其他行為導致的任何主張、損害或其他責任中，作者或版權持有者概不負責。