Alpha Vantage Stock MCP Server

Alpha Vantage Stock MCP Server

site icon
2025.03.14 1
TypeScript股票市场数据金融数据分析金融服务
Alpha Vantage Stock MCP Server 是一个基于 Alpha Vantage API 的股票市场数据服务,通过 Model Context Protocol (MCP) 协议为 Claude 和其他 MCP 客户端提供实时和历史股票数据。该服务支持获取日内股票数据、每日股票数据、生成基于价格变动的股票警报,并将股票数据作为资源直接访问。
View on GitHub

Overview

基本能力

产品定位

Alpha Vantage Stock MCP Server 是一个股票市场数据服务,通过 MCP 协议为客户端提供实时和历史股票数据。

核心功能

  • 获取可定制时间间隔的日内股票数据
  • 获取每日股票数据
  • 基于价格变动生成股票警报
  • 将股票数据作为资源直接访问

适用场景

  • 股票市场数据分析
  • 实时股票价格监控
  • 股票价格变动警报
  • 股票历史数据研究

工具列表

  1. get-stock-data: 获取特定股票的日内数据
  2. 参数: symbol(必需), interval(可选), outputsize(可选)
  3. get-daily-stock-data: 获取特定股票的每日数据
  4. 参数: symbol(必需), outputsize(可选)
  5. get-stock-alerts: 分析股票数据并生成基于价格变动的警报
  6. 参数: symbol(必需), threshold(可选)

资源

  • stock-data: 直接访问股票数据
  • URI 模板: stock://{symbol}/{interval}

常见问题解答

  • 需要 Alpha Vantage API 密钥才能使用该服务
  • 需要 Node.js 16 或更高版本

使用教程

使用依赖

  • Node.js 16 或更高版本
  • Alpha Vantage API 密钥(可从 https://www.alphavantage.co/support/#api-key 免费获取)

安装教程

  1. 克隆仓库
  2. 安装依赖: npm install
  3. 在根目录创建 .env 文件并添加 API 密钥: ALPHA_VANTAGE_API_KEY=your_api_key_here

构建和运行

构建 TypeScript 代码:

npm run build

运行服务器:

npm start

开发模式(自动重载):

npm run dev

测试 API 客户端:

npm test

与 Claude for Desktop 一起使用

  1. 打开 Claude for Desktop
  2. 转到 Settings > Developer > Edit Config
  3. claude_desktop_config.json 中添加配置
  4. 重启 Claude for Desktop

调试方式

  • 使用 npm test 测试 API 客户端
  • 开发模式下会自动重载代码更改

许可证

该项目遵循 ISC 开源许可条款。