AI导哈

事件数据分析服务

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

  • by silviorodrigues
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 silviorodrigues/amplitude-mcp

使用说明

振幅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：您的振幅密钥（必填）

可用工具

1.查询事件

使用过滤器进行基本事件查询。

参数：

  • events （array）：要查询的事件数组
    • eventType （string）：事件类型
    • 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.分段事件

高级事件细分和细分。

参数：

  • 所有参数来自 query_events
  • filters （数组，可选）：用于分割的附加过滤器
    • type （string）：筛选器类型（属性、事件、用户）
    • propertyName （字符串，可选）：属性的名称
    • value （混合，可选）：要筛选的值
    • op （字符串，可选）：用于比较的运算符
  • breakdowns （数组，可选）：分解维度
    • type （字符串）：故障类型（事件、用户）
    • propertyName （string）：要分解的属性的名称

例子：

{
  "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"
    }
  ]
}

可用资源

振幅_事件

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

URI格式：

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

例子：

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

发展

项目结构

amplitude-mcp/
├── src/
│   ├── index.ts                  # Main entry point with MCP server setup
│   ├── services/
│   │   └── amplitude.service.ts  # Amplitude API service implementation
│   ├── resources/
│   │   └── events.ts             # Event data resources
│   ├── types/
│   │   └── amplitude.ts          # Amplitude API types
│   └── utils/
│       └── config.ts             # Configuration and credential handling
├── bin/
│   └── cli.js                    # CLI entry point
├── dist/                         # Compiled JavaScript files
├── package.json
└── tsconfig.json

许可证

麻省理工学院

相关 MCP