Alpha Vantage股票MCP服务器

这是一个使用Alpha Vantage API提供股票市场数据的Model Context Protocol (MCP) 服务器。它允许Claude和其他MCP客户端访问实时和历史股票数据。

功能

• 获取可自定义间隔的盘中股票数据
• 获取每日股票数据
• 根据价格波动生成股票警报
• 以资源形式访问股票数据

先决条件

• Node.js 16或更高版本
• Alpha Vantage API密钥（免费获取地址：Alpha Vantage）

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 在项目根目录下创建一个.env文件，并添加您的Alpha Vantage API密钥：

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

构建和运行

构建TypeScript代码：

npm run build

运行服务器：

npm start

在开发环境中使用自动重启：

npm run dev

测试API客户端：

npm test

与Claude桌面版一起使用

要将此MCP服务器与Claude桌面版一起使用：

1. 打开Claude桌面版
2. 转到设置 > 开发者 > 编辑配置
3. 将以下内容添加到claude_desktop_config.json中：

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      } 
    }
  }
}

将/absolute/path/to/dist/index.js替换为实际构建的index.js文件的绝对路径。

4. 重启Claude桌面版

可用工具

get-stock-data

获取特定股票的盘中数据。

参数：

• symbol（必需）：股票代码（例如IBM、AAPL）
• interval（可选）：数据点之间的时间间隔（1min、5min、15min、30min、60min）。默认：5min
• outputsize（可选）：返回的数据量（compact：最新100个数据点，full：最多20年的数据）。默认：compact

get-daily-stock-data

获取特定股票的每日数据。

参数：

• symbol（必需）：股票代码（例如IBM、AAPL）
• outputsize（可选）：返回的数据量（compact：最新100个数据点，full：最多20年的数据）。默认：compact

get-stock-alerts

分析股票数据并生成价格波动警报。

参数：

• symbol（必需）：股票代码（例如IBM、AAPL）
• interval（可选）：监控间隔。默认：5min
• threshold（可选）：波动阈值百分比。默认：2%

可用资源

股票数据资源

通过以下URI格式访问股票数据：

stock://<symbol>[?<interval>&<outputsize>]

参数：

• symbol：股票代码
• interval（可选）：数据间隔，默认为5min
• outputsize（可选）：输出大小，compact或full

示例

获取AAPL的每日数据：

stock://AAPL?interval=1day&outputsize=full

许可证

[此处插入许可证信息]