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 for Desktop 一起使用

要将此 MCP 服务器与 Claude for Desktop 一起使用：

1. 打开 Claude for Desktop
2. 转到 Settings > Developer > Edit Config
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 for Desktop

可用工具

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)
• threshold (可选): 价格变动警报的百分比阈值。 默认值：5

可用资源

stock-data

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

URI 模板: stock://{symbol}/{interval}

参数：

• symbol: 股票代码 (例如，IBM, AAPL)
• interval: 时间间隔 (daily, 1min, 5min, 15min, 30min, 60min)。 默认值：daily

在 Claude 中的使用示例：

• "你能分析一下这个股票数据吗：stock://AAPL/daily"
• "你觉得这个数据怎么样：stock://MSFT/5min"

许可证

ISC