Alpha Vantage MCP Server

这是一个 Model Context Protocol (MCP) 服务器，通过免费的 Alpha Vantage API 提供实时金融市场数据访问。

功能概览

• 实时股票报价数据（价格、成交量、变化）
• 详细公司信息（行业、市场部门、市值）
• 实时加密货币汇率
• 股票历史时间序列数据
• 历史期权链数据（支持排序和过滤）

安装方法

方法一：通过 Smithery（推荐）

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

方法二：通过 Docker

1. 克隆仓库并构建镜像：

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

2. 配置 Claude Desktop 客户端（在claude_desktop_config.json）：

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

可用工具一览

get-stock-quote

获取特定公司的最新股票报价

{"symbol": "AAPL"}

get-company-info

获取特定公司的详细信息

{"symbol": "MSFT"}

get-crypto-exchange-rate

获取实时加密货币汇率

{"crypto_symbol": "BTC", "market": "USD"}

get-time-series

获取股票历史价格数据

{"symbol": "AAPL", "outputsize": "compact"}

get-historical-options

获取历史期权链数据

{
  "symbol": "AAPL",
  "sort_by": "strike",
  "sort_order": "asc",
  "limit": 5
}

开发环境设置

1. 安装包：

uv install -e .

2. 运行服务器：

uv run src/alpha_vantage_mcp/server.py

3. 使用检查器运行：

npx @modelcontextprotocol/inspector uv --directory /PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py

注意：使用前需要获取 Alpha Vantage API 密钥