振幅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许可证
麻省理工学院