Alpha Vantage MCP Server

Alpha Vantage MCP Server

site icon
2025.04.17 30
Python金融数据服务股票市场分析加密货币数据金融服务
Alpha Vantage MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,通过免费的 Alpha Vantage API 提供实时金融市场数据访问。该服务器实现了标准化的接口,用于检索股票报价和公司信息。
View on GitHub

Overview

基本能力

产品定位

Alpha Vantage MCP Server 是一个金融数据服务,提供实时股票报价、公司信息、加密货币汇率和历史期权数据。

核心功能

  • 实时股票报价(价格、成交量、涨跌幅)
  • 详细公司信息(行业、市值等)
  • 实时加密货币汇率(买入/卖出价)
  • 历史期权链数据(支持高级筛选和排序)
  • 内置错误处理和速率限制管理

适用场景

  • 金融数据分析
  • 投资决策支持
  • 市场趋势研究
  • 量化交易系统

工具列表

  1. get-stock-quote: 获取特定公司的最新股票报价
  2. get-company-info: 获取特定公司的股票相关信息
  3. get-crypto-exchange-rate: 获取当前加密货币汇率
  4. get-time-series: 获取股票的每日历史价格数据
  5. get-historical-options: 获取历史期权链数据

常见问题解答

  • 错误处理包括:速率限制、无效API密钥、网络连接问题、超时处理和格式错误的响应

使用教程

使用依赖

  • Python 3.12或更高版本
  • httpx
  • mcp

安装教程

通过Docker安装

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .

配置claude_desktop_config.json文件(路径见下文):

{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

通过Smithery安装

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

调试方式

运行服务器:

uv run src/alpha_vantage_mcp/server.py

使用检查器运行:

npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。