返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端