🚀 Alpha Vantage 股票 MCP 服务器

这是一个基于模型上下文协议 (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 Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用，可按以下步骤操作：

1. 打开 Claude Desktop。
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 替换为您构建目录中的实际路径。 4. 重启 Claude Desktop。

📚 详细文档

可用工具

get-stock-data

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

get-daily-stock-data

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

get-stock-alerts

分析股票数据以生成价格波动相关的警报。

可用资源

stock-data

直接作为资源访问股票数据。

示例用法：

• “Can you analyze this stock data: stock://AAPL/daily”
• “What do you think about this data: stock://MSFT/5min”

📄 许可证

本项目采用 ISC 许可证。