Amplitude MCP 服务器

用于 Amplitude Analytics API 的模型上下文协议 (MCP) 服务器，提供查询和细分事件数据的工具和资源。

概述

此 MCP 服务器使 AI 助手和其他 MCP 客户端能够与 Amplitude Analytics API 进行交互，允许它们：

• 使用过滤器查询事件数据
• 执行具有细分维度的高级细分
• 通过结构化资源访问事件数据

安装

{
  "mcpServers": {
    "amplitude": {
      "command": "npx",
      "args": [
        "-y",
        "amplitude-mcp",
        "--amplitude-api-key=YOUR_API_KEY",
        "--amplitude-secret-key=YOUR_SECRET_KEY"
      ]
    }
  }
}

必需的凭证

必须通过命令行参数提供 Amplitude API 凭证：

• --amplitude-api-key: 您的 Amplitude API 密钥（必需）
• --amplitude-secret-key: 您的 Amplitude 秘密密钥（必需）

可用工具

1. query_events

带有过滤器的基本事件查询。

参数：

• events (数组): 要查询的事件数组
  • eventType (字符串): 事件类型
  • propertyFilters (数组，可选): 事件属性过滤器
• start (字符串): 开始日期，YYYYMMDD 格式
• end (字符串): 结束日期，YYYYMMDD 格式
• interval (字符串，可选): 分组间隔（天、周、月）
• groupBy (字符串，可选): 分组维度

示例：

{
  "events": [
    {
      "eventType": "user_login",
      "propertyFilters": [
        {
          "propertyName": "device_type",
          "value": "mobile",
          "op": "is"
        }
      ]
    }
  ],
  "start": "2023-01-01",
  "end":  "2023-01-31",
  "interval": "day"
}

2. segment_events

带有细分维度的高级事件细分。

参数：

• 来自 query_events 的所有参数
• filters (数组，可选): 额外的细分过滤器
  • type (字符串): 过滤器类型（属性、事件、用户）
  • propertyName (字符串，可选): 属性名称
  • value (混合类型，可选): 过滤值
  • op (字符串，可选): 比较运算符
• breakdowns (数组，可选): 细分维度
  • type (字符串): 细分类型（事件、用户）
  • propertyName (字符串): 要细分的属性名称

示例：

{
  "events": [
    {
      "eventType": "purchase"
    }
  ],
  "start": "2023-01-01",
  "end": "2023-01-31",
  "interval": "week",
  "filters": [
    {
      "type": "user",
      "propertyName": "country",
      "value": "US",
      "op": "is"
    }
  ],
  "breakdowns": [
    {
      "type": "user",
      "propertyName": "device_type"
    }
  ]
}

可用资源

amplitude_events

访问特定事件类型和日期范围内的事件数据。

URI 格式：

amplitude://events/{eventType}/{start}/{end}

示例：

amplitude://events/user_login/2023-01-01/2023-01-31

开发

项目结构

amplitude-mcp/
├── src/
│   ├── index.ts                  # 主入口点，包含 MCP 服务器设置
│   ├── services/
│   │   └── amplitude.service.ts  # Amplitude API 服务实现
│   ├── resources/
│   │   └── events.ts             # 事件数据资源
│   ├── types/
│   │   └── amplitude.ts          # Amplitude API 类型定义
│   └── utils/
│       └── config.ts             # 配置和凭证处理
├── bin/
│   └── cli.js                    # 命令行入口点
├── dist/                         # 编译后的 JavaScript 文件
├── package.json
└── tsconfig.json

许可证

MIT </中文翻译>