AI导哈

金融数据API服务

Alpha Vantage MCP Server是一个提供股票、外汇、加密货币、商品和经济指标等金融数据API的综合模型上下文协议服务器。

  • by OriShmila
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 orishmila/alpha-vantage-mcp-server

使用说明

Alpha Vantage MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供对Alpha Vantage财务数据API的访问，包括股票、外汇、加密货币、商品和经济指标。

🚀 特性

核心股票API

  • 实时行情：获取当前股票价格和指标
  • 时间序列数据：每日、每周、每月和日内数据
  • 符号搜索：按公司名称或股票代码查找股票

基础数据

  • 公司概况：完整的公司信息和财务状况
  • 财务报表：损益表、资产负债表、现金流量表
  • 收益数据：历史收益和电话财报会议记录

技术指标

  • 移动平均值：SMA、EMA、DEMA、TEMA、TRIMA、KAMA、妈妈、VWAP、T3
  • 动量指标：RSI、MACD、随机指标、威廉姆斯%R、ROC、MOM
  • 波动性指标：布林带、ATR、NATR
  • 音量指示器：OBV、A/D线、A/D振荡器、MFI

市场情报

  • 新闻情绪：使用情绪评分的人工智能新闻分析
  • 市场推手：涨幅最大、跌幅最大和最活跃的股票
  • 市场现状：全球交易所状态和交易时间

外汇和货币

  • 实时汇率：货币兑换率
  • FX时间序列：具有多个时间框架的历史外汇数据

经济指标

  • GDP数据：实际国内生产总值和人均国内生产总值
  • 美联储：利率、货币供应量
  • 劳动统计：失业、非农就业
  • 通货膨胀数据：CPI和通货膨胀率

商品

  • 能量：WTI原油、布伦特原油、天然气
  • 金属：铜、铝
  • 农业：小麦、玉米、棉花、糖、咖啡

📦 安装

先决条件

设置

  1. 克隆并安装:

    git clone https://github.com/yourusername/alpha-vantage-mcp-server
cd alpha-vantage-mcp-server
uv sync

  2. 配置API密钥:

    cp .env.example .env
# Edit .env and add your Alpha Vantage API key

  3. 测试安装:

    uv run python test_server.py

🔧 配置

环境变量

创建一个 .env 使用您的Alpha Vantage API密钥提交：

# Required: Your Alpha Vantage API key
ALPHA_VANTAGE_KEY=your_api_key_here

# Optional: Debug mode
DEBUG=false

速率限制

  • 免费等级：每天25个请求，每分钟5个请求
  • 高级计划：起价49.99美元/月，限额更高
  • 访问 阿尔法Vantage高级版 详见

🎯 与MCP客户端一起使用

Claude桌面配置

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/yourusername/alpha-vantage-mcp-server",
        "alpha-vantage-mcp-server"
      ],
      "env": {
        "ALPHA_VANTAGE_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

该服务器提供25多种全面的工具，涵盖所有主要的财务数据类别：

核心市场数据

  • get_current_stock_quote -格式简洁的实时股票报价
  • get_stock_time_series -历史价格数据（每日、每周、每月、日内）
  • lookup_stock_symbol -按公司名称或代码搜索股票
  • 获取全球市场状态 -全球交易所状态和交易时间

技术分析

  • get_trend_indicators -SMA、EMA、WMA、MACD，具有预设配置
  • get_momentum_indicators -RSI、随机指标、CCI、MFI指标
  • get_volatility_indicators -布林带、ATR、SAR指标
  • get_volume_indicators -OBV、A/D线路、A/D振荡器

基础数据

  • get_symbol_overview -公司简介和关键指标
  • 获取_财务_项目 -损益表、资产负债表、现金流量表
  • 获取学习数据 -历史收益，按季度细分
  • get_corporate_actions -股息历史和股票分割

市场情报

  • get_news_sention -基于人工智能的新闻分析与情绪评分
  • get_top_gainers_loser -市场推动者和最活跃的股票
  • get_stock_insider_transactions -内幕交易活动
  • 分析库存 -高级分析和统计计算

外汇和加密货币

  • get_current_fx_rate -实时货币汇率
  • get_fx_time_series -具有多个时间间隔的历史外汇数据
  • get_current_crypto_quote -当前加密货币市场报价
  • get_crypto_time_series -历史加密货币价格数据

经济指标

  • get_growth_metrics -GDP和经济增长数据
  • get_rates_yields -国债收益率和联邦基金利率
  • get_prices_inflation -CPI和通货膨胀指标
  • get_labor_activity -就业和劳动力市场数据
  • get_修改 -全球商品定价数据

市场日历

  • 获取市场日历 -收益公告和IPO日历
  • get_listing_status -股票上市和退市信息
  • 获取历史选项 -期权交易数据

🧪 测试

运行综合测试套件：

uv run python test_server.py

测试套件包括：

  • ✅ 所有工具的模式验证
  • ✅ 输入参数验证
  • ✅ 输出格式验证
  • ✅ 错误处理测试
  • ✅ 限速意识

📊 示例用法

获取股票报价

# Through MCP client:
await get_current_stock_quote(symbol="AAPL")

技术分析

# Get momentum indicators for Apple stock
await get_momentum_indicators(
    symbol="AAPL",
    interval="daily", 
    preset="standard"
)

市场情报

# Get news sentiment for multiple stocks
await get_news_sentiment(
    tickers=["AAPL", "MSFT", "GOOGL"]
)

经济数据

# Get latest GDP data
await get_growth_metrics(
    frequency="quarterly",
    seasonally_adjusted=true
)

高级分析

# Perform statistical analysis on stock data
await analyze_stocks(
    symbols=["AAPL", "MSFT"],
    interval="DAILY",
    calculations=["MEAN", "STDDEV", "CORRELATION"],
    series_range="6month"
)

🔍 API覆盖范围

此MCP服务器实现 25+综合工具 利用AlphaVantage广泛的API覆盖范围：

  • 核心市场数据 （4个统一的工具，覆盖10+个端点）
  • 技术分析 （4个指标包，涵盖15+个指标）
  • 基础数据 （4种涵盖公司财务的工具）
  • 市场情报 （4个新闻、动态和内幕数据工具）
  • 外汇和加密货币 （4种货币和加密数据工具）
  • 经济指标 （4个工具涵盖GDP、通货膨胀、就业）
  • 商品和日历 （商品和市场活动的3个工具）

每个工具都是为最佳可用性而设计的，具有预设配置和干净、结构化的输出。

⚠️ 重要提示

速率限制

  • 免费套餐有严格的限制（每天25个请求）
  • 生产使用需要高级订阅
  • 服务器优雅地处理速率限制

数据格式

  • 所有响应均遵循Alpha Vantage的JSON结构
  • 所选端点支持CSV格式
  • 包括全面的错误处理

最佳实践

  • 尽可能缓存响应
  • 遵守费率限制
  • 为您的用例使用适当的间隔
  • 监控API使用情况

🛠️ 发展

项目结构

alpha-vantage-mcp-server/
├── alpha_vantage_mcp_server/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py          # MCP server implementation
│   ├── handlers.py        # Unified tool function implementations
│   ├── api_helpers.py     # Alpha Vantage API client functions
│   └── tools.json         # Complete tool schema definitions
├── test_cases.json        # Test scenarios
├── test_server.py         # Test runner
├── pyproject.toml         # Project configuration
└── README.md

添加新工具

  1. 添加功能实现 handlers.py
  2. 将工具架构定义添加到 tools.json
  3. 更新 TOOL_FUNCTIONS 在中映射 handlers.py
  4. 添加全面的测试用例 test_cases.json
  5. 运行测试以确保模式验证通过

📈 路线图

  • []添加更多经济指标工具
  • []实现智能缓存层
  • []添加数据导出实用程序
  • []扩展错误处理和重试逻辑
  • []添加请求批处理优化
  • []为常见分析工作流创建预设集合

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 添加新功能的测试
  4. 确保所有测试通过
  5. 提交拉取请求

📄 许可证

[在此处添加您的许可证]

🙏 致谢

准备好用人工智能分析金融市场了吗？获取您的免费Alpha Vantage API密钥并开始探索！ 🚀📈

相关 MCP