Alpha Vantage MCP Server

什么是 Alpha Vantage MCP Server？

Alpha Vantage MCP Server 是 Alpha Vantage 市场数据 API 的官方托管 MCP 服务器。它让 Claude、ChatGPT、Cursor、VS Code 等客户端获取实时和历史的股票、期权、外汇、加密货币、大宗商品、经济和技术指标数据。

Alpha Vantage 是一个由开发者、投资者、学生和教育工作者使用的金融数据 API。MCP 服务器把 Alpha Vantage 的函数直接作为 MCP 工具提供：客户端通过 tools/list 发现它们并按名称调用，例如 TIME_SERIES_DAILY(symbol="IBM", outputsize="compact")。它已上架 Claude 的连接器目录和 ChatGPT 的应用目录，源代码位于 GitHub 的 alphavantage/alpha_vantage_mcp。

如何使用 Alpha Vantage MCP Server？

首先，在 alphavantage.co 申请一个免费的 Alpha Vantage API key。推荐的远程连接方式使用 OAuth：

https://mcp.alphavantage.co/mcp

连接时，浏览器会打开一个认证页面，你在其中输入并授权你的 Alpha Vantage API key。之后如需更换 key，断开并重新连接，然后输入新 key 即可。

Claude Code

claude mcp add --transport http alphavantage https://mcp.alphavantage.co/mcp

然后运行 /mcp，选择 alphavantage 并在浏览器中完成认证。Alpha Vantage 还提供本地方式：claude mcp add alphavantage -- uvx marketdata-mcp-server YOUR_API_KEY。

Claude Desktop 和 claude.ai

进入 Settings → Connectors，点击 Add → Browse connectors，搜索“Alpha Vantage”，打开 Alpha Vantage MCP Server，点击 Connect，在认证页面输入 API key 并点击 Authorize Access。任何免费或付费 Claude 账号都可以使用。

Cursor

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "alphavantage": {
      "url": "https://mcp.alphavantage.co/mcp"
    }
  }
}

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "alphavantage": {
      "type": "http",
      "url": "https://mcp.alphavantage.co/mcp"
    }
  }
}

Alpha Vantage 的 README 还展示了一种旧方式，为不支持 OAuth 的客户端把 key 放在 URL 中（https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY）。它已被标记为弃用，而且放在 URL 中的 key 容易泄露，因此请优先使用 OAuth URL。

Alpha Vantage MCP Server 的主要功能

• Alpha Vantage 官方服务器，连接器已通过 Anthropic 和 OpenAI 认证上架。
• OAuth 流程把 API key 保存在服务端，而不是本地配置文件中。
• 核心股票 API：日内、日、周、月时间序列（复权和未复权）、报价、批量报价、代码搜索和市场状态。
• 期权数据，以及 Alpha Intelligence：新闻情绪、财报电话会议记录、涨跌幅榜、内部人交易和机构持仓。
• 基本面：公司概况、利润表、资产负债表、现金流量表、盈利以及 IPO 日历。
• 外汇、加密货币、大宗商品（原油、天然气、金属、农产品）以及 GDP、CPI、国债收益率和失业率等美国经济指标。
• 50 多个技术指标，包括 SMA、EMA、MACD、RSI 和布林带（BBANDS）。
• 通过 CONGRESS_TRADES 和 POLITICIAN_METADATA 获取国会议员交易数据。

Alpha Vantage MCP Server 的使用场景

• 价格历史：“给我 IBM 上周的 OHLCV 数据。”
• 技术分析：“获取 NVDA 的日内价格和 RSI，告诉我是否超买。”
• 基本面：“绘制苹果过去两年的季度盈利图表。”
• 跨资产比较：“比较黄金、白银和比特币的月度表现。”
• 宏观背景：“过去一年联邦基金利率和 CPI 是怎么变化的？”
• 新闻扫描：“总结特斯拉近期的新闻情绪。”

Alpha Vantage MCP Server 常见问题排查

• 很快就达到请求限制。 Alpha Vantage 标准免费用量为每天 25 次 API 请求。高级套餐可提高限制（每分钟 75 次起）并解锁高级函数。
• 需要更换 API key。 断开服务器，重新连接，并在认证页面输入新 key。
• 模型凭记忆回答而不调用工具。 Alpha Vantage 建议告诉智能体其函数以 MCP 工具形式提供，并且始终使用该服务器获取市场数据。
• 客户端不支持 OAuth。 使用本地的 uvx marketdata-mcp-server YOUR_API_KEY，或者作为最后手段使用已弃用的 ?apikey= URL。