Back to MCP directory
publicPublicdnsLocal runtime

alphavantage_mcp

Alpha Vantage MCP是一个提供股票和金融数据访问的模型上下文协议服务器,整合了Alpha Vantage所有API端点功能,并通过优化端点组织减少上下文窗口使用。

article

README

🚀 Alpha Vantage MCP 服务器

Alpha Vantage MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器,可用于访问 Alpha Vantage 的股票和金融数据,为用户提供便捷的金融数据查询服务。

✨ 主要特性

  • 全面支持 Alpha Vantage API 的各类端点,涵盖股票、经济指标、技术指标、外汇、加密货币以及大宗商品等领域。
  • 为有效减少上下文窗口的占用,部分端点进行了整合处理,如技术指标、外汇、大宗商品和加密货币相关端点。

📚 详细文档

API 组织

为了提供更高效的使用体验并显著降低上下文窗口的使用,对 API 进行了如下优化组织:

  • 技术指标:整合为 5 个统一端点,分别为移动平均线、动量、波动率、成交量和周期,每个端点带有类型参数。
  • 大宗商品:通过 commodity_type 参数将相关操作统一到一个端点。
  • 外汇:时间序列端点借助 series_type 参数进行整合。
  • 加密货币:时间序列端点同样通过 series_type 参数完成整合。

这种组织方式在保留所有功能的基础上,大幅减少了所需工具的数量。

📦 安装指南

  1. 克隆此仓库。
  2. 安装依赖项:
npm install
  1. 复制示例环境文件:
cp .env.example .env
  1. 编辑 .env 文件,并添加您的 Alpha Vantage API 密钥。您可以在 Alpha Vantage 免费获取 API 密钥。
  2. 构建项目:
npm run build

💻 使用示例

连接到 Claude 客户端

此 MCP 服务器可与任何兼容的客户端(如 Claude)配合使用。以下是一些示例查询:

  • "获取 MSFT 的股票报价"
  • "显示 AAPL 的 RSI 动量指标,周期为 14 天"
  • "USD 和 EUR 的汇率是多少?"
  • "获取比特币 USD 每月的价格数据"
  • "显示原油在过去一个季度的价格"

📄 许可证

本项目采用 MIT 许可证。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client