@qubaomingg/stock-mcp

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