Alpha Vantage MCP Server 是一个 Model Context Protocol (MCP) 服务器，旨在通过免费的 Alpha Vantage API 提供对金融市场的实时数据访问。它实现了标准化接口，用于检索股票报价和公司信息。
主要能力包括：
- 实时股票报价，包含价格、成交量和变动数据
- 详细的公司信息，包括板块、行业和市值
- 实时加密货币汇率，包含买入/卖出价格
- 每日、每周和每月的加密货币时间序列数据
- 实时期权链数据，包含希腊值和隐含波动率
- 历史期权链数据，支持高级过滤和排序
- 全面的 ETF 资料数据，包含持仓、板块配置和关键指标
- 即将到来的财报日历，可自定义时间范围
- 历史财报数据，包含年度和季度报告
- 内置错误处理和速率限制管理
使用方式： 通过 Claude Desktop 使用：
- 克隆仓库并构建本地镜像，供 Claude 桌面客户端使用。
- 修改 claude_desktop_config.json 文件，将 REPLACE_API_KEY 替换为实际密钥。
- MacOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows 路径：%APPDATA%/Claude/claude_desktop_config.json
- 可通过 Smithery 自动安装 Alpha Vantage MCP Server 到 Claude Desktop。
- 在通过 JSON 文件连接 Claude 客户端并安装包后，Claude 应能看到服务器的 MCP 工具。
- 可以在 alpha-vantage-mcp 仓库中自行运行服务器。
可用工具（共十二个）：
- get-stock-quote：获取特定公司的最新股票报价
- get-company-info：获取特定公司的股票相关信息
- get-crypto-exchange-rate：获取当前加密货币汇率
- get-time-series：获取股票的历史每日价格数据
- get-realtime-options：获取实时期权链数据，包含希腊值和隐含波动率
- get-historical-options：获取历史期权链数据，支持高级过滤和排序
- get-etf-profile：获取全面的 ETF 资料信息，包括持仓和板块配置
- get-crypto-daily：获取加密货币的每日时间序列数据
- get-crypto-weekly：获取加密货币的每周时间序列数据
- get-crypto-monthly：获取加密货币的每月时间序列数据
- get-earnings-calendar：获取公司即将到来的财报日历数据
- get-historical-earnings：获取特定公司的历史财报数据
注意：get-realtime-options 端点需要 Alpha Vantage Premium 订阅（600 请求/分钟或 1200 请求/分钟计划）。标准 75 请求/分钟计划和免费账户将收到占位符/演示数据，而非真实市场数据。对于大多数用例，建议使用 get-historical-options，它适用于所有 API 密钥层级。
错误处理：服务器包含针对各种场景的全面错误处理，包括速率限制超出、无效 API 密钥、网络连接问题、超时处理和格式错误的响应。错误消息以清晰、人类可读的格式返回。
系统要求：Python 3.12 或更高版本。
该 MCP 服务器采用 MIT 许可证。
