Alpha Vantage Stock Analysis MCP Server

🚀 Alpha Vantage股票MCP服务器

本项目是一个基于Alpha Vantage API的Model Context Protocol (MCP) 服务器，主要用于提供股票市场数据。借助该服务器，Claude及其他MCP客户端能够便捷地访问实时和历史股票数据。

🚀 快速开始

本服务器使用Alpha Vantage API提供股票市场数据，支持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（可选）：数据间隔，默认为5min
• outputsize（可选）：输出大小，compact或full

示例

获取AAPL的每日数据：

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

📄 许可证

[此处插入许可证信息]