Amplitude MCP Server

Amplitude MCP Server

site icon
2025.04.18 0
JavaScript数据分析AI集成开发效率
Amplitude MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于将 Amplitude 分析功能集成到 AI 工作流中。该服务器允许 AI 助手(如 Claude)在 Amplitude 中跟踪事件、页面浏览、用户注册、设置用户属性以及跟踪收入。
View on GitHub

Overview

基本能力

产品定位

Amplitude MCP Server 是一个连接 AI 工作流和 Amplitude 分析平台的桥梁,使 AI 助手能够直接进行数据分析跟踪。

核心功能

  • 在 Amplitude 中跟踪自定义事件
  • 跟踪带有属性的页面浏览
  • 跟踪用户注册并创建用户档案
  • 更新现有用户属性
  • 跟踪收入和购买
  • 与 Claude Desktop 和其他 MCP 客户端的简单集成

适用场景

  • AI 助手需要跟踪用户行为数据
  • 自动化分析用户交互和转化
  • 集成 Amplitude 分析到 AI 工作流中
  • 跟踪产品收入和用户生命周期事件

工具列表

  1. amplitude_track_event: 跟踪 Amplitude 中的自定义事件
  2. amplitude_track_pageview: 跟踪页面浏览事件
  3. amplitude_track_signup: 跟踪注册事件并创建用户档案
  4. amplitude_set_user_properties: 更新用户档案属性
  5. amplitude_track_revenue: 跟踪收入事件

常见问题解答

  1. 服务器无法启动: 确保提供了有效的 Amplitude API 密钥,并检查 Node.js 版本是否为 16 或更高
  2. Claude Desktop 不显示 Amplitude 工具: 验证配置文件语法,确保重启了 Claude Desktop
  3. 事件未出现在 Amplitude 中: 检查 API 密钥是否正确,事件可能需要几分钟才会显示

使用教程

使用依赖

  • Node.js 16 或更高版本
  • Amplitude API 密钥(在 Amplitude 注册获取)

安装教程

NPM 安装(推荐)

# 全局安装
npm install -g amplitude-mcp-server

# 或直接使用 npx
npx amplitude-mcp-server --api-key YOUR_AMPLITUDE_API_KEY

手动安装

# 克隆仓库
git clone https://github.com/ciaraadkins/amplitude-mcp-server.git
cd amplitude-mcp-server

# 安装依赖
npm install

# 运行服务器
node index.js --api-key YOUR_AMPLITUDE_API_KEY

调试方式

运行调试模式以获取更详细的日志:

npx amplitude-mcp-server --api-key YOUR_AMPLITUDE_API_KEY --debug

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。