星战科技xingzhan.cloud
返回市场
振幅-MCP服务器

振幅-MCP服务器

作者：moonbirdai7 星标更新：2025-04-18
安装使用来源：spider==github.com

项目介绍

Amplitude MCP 服务器

一个用于将 Amplitude 分析集成到 AI 工作流中的 模型上下文协议 (MCP) 服务器。此服务器允许像 Claude 这样的 AI 助手跟踪事件、页面浏览量、用户注册、设置用户属性以及在 Amplitude 中跟踪收入。

版本 1.0.1 注意事项： 工具名称现在包括 amplitude_ 前缀，以防止与其他分析 MCP 服务器发生命名空间冲突。

目录

特性

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

安装

先决条件

  • 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

快速开始

要开始使用 Amplitude MCP 服务器与 Claude Desktop：

  1. 确保 Claude Desktop 已安装在您的机器上（从 claude.ai/download 下载）
  2. 创建或编辑 Claude Desktop 配置文件：
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %AppData%\Claude\claude_desktop_config.json
  3. 添加 Amplitude MCP 服务器配置：
{
  "mcpServers": {
    "amplitude-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "amplitude-mcp-server",
        "--api-key",
        "YOUR_AMPLITUDE_API_KEY"
      ]
    }
  }
}
  1. 重启 Claude Desktop 并开始跟踪分析！

详细用法

与 Claude Desktop 一起使用

按照快速开始部分设置配置文件后，您可以在与 Claude 的对话中直接使用 Amplitude 分析功能。

您可以使用的提示示例：

  • "在 Amplitude 中为用户 'user123' 跟踪名为 'document_generated' 的自定义事件"
  • "在 Amplitude 中跟踪定价页面的页面浏览量"
  • "在 Amplitude 中为 John Doe 创建一个新用户档案，电子邮件地址为 john@example.com"
  • "更新 Amplitude 中用户 'user123' 的用户档案信息"
  • "跟踪用户购买了价值 $49.99 的产品 X"

Claude 将根据您的请求使用适当的 Amplitude MCP 工具。

与其他 MCP 客户端一起使用

此服务器使用标准的 Model Context Protocol，并可以与任何 MCP 客户端集成：

  1. 启动服务器： 
    npx amplitude-mcp-server --api-key YOUR_AMPLITUDE_API_KEY
  2. 使用 stdio 传输连接您的 MCP 客户端到服务器
  3. 客户端可以发现并使用可用的工具（track_event, track_pageview, track_signup, set_user_properties, track_revenue）

工具参考

Amplitude MCP 服务器提供以下工具：

amplitude_track_event

在 Amplitude 中跟踪自定义事件。

参数：

  • event_name (字符串，必需)：要跟踪的事件名称
  • user_id (字符串，可选)：用户标识符
  • device_id (字符串，可选)：设备标识符
  • properties (对象，可选)：要与事件一起跟踪的附加属性
  • user_properties (对象，可选)：要与此事件一起更新的用户属性

注意： 必须提供 user_id 或 device_id。

示例：

{
  "event_name": "button_clicked",
  "user_id": "user123",
  "properties": {
    "button_id": "submit_form",
    "page": "checkout"
  },
  "user_properties": {
    "last_action": "form_submit"
  }
}

amplitude_track_pageview

在 Amplitude 中跟踪页面浏览事件。

参数：

  • page_name (字符串，必需)：所查看页面的名称
  • user_id (字符串，可选)：用户标识符
  • device_id (字符串，可选)：设备标识符
  • properties (对象，可选)：要与事件一起跟踪的附加属性

注意： 必须提供 user_id 或 device_id。

示例：

{
  "page_name": "homepage",
  "user_id": "user123",
  "properties": {
    "referrer": "google.com",
    "duration": 120
  }
}

amplitude_track_signup

跟踪注册事件并在 Amplitude 中创建用户档案。

参数：

  • user_name (字符串，必需)：用户的全名
  • email (字符串，必需)：用户的电子邮件地址
  • plan (字符串，可选)：注册计划，默认为 'free'

示例：

{
  "user_name": "John Doe",
  "email": "john@example.com",
  "plan": "premium"
}

amplitude_set_user_properties

在 Amplitude 中更新用户的档案属性。

参数：

  • user_id (字符串，必需)：用户标识符
  • properties (对象，必需)：要设置的档案属性

示例：

{
  "user_id": "user123",
  "properties": {
    "name": "John Doe",
    "email": "john@example.com",
    "plan": "premium",
    "company": "Acme Inc"
  }
}

amplitude_track_revenue

在 Amplitude 中跟踪收入事件。

参数：

  • user_id (字符串，必需)：用户标识符
  • product_id (字符串，必需)：购买的产品标识符
  • price (数字，必需)：购买的商品价格
  • quantity (数字，可选)：购买的商品数量，默认为 1
  • revenue_type (字符串，可选)：收入类型（例如，'purchase', 'refund', 'subscription'）

示例：

{
  "user_id": "user123",
  "product_id": "premium_plan",
  "price": 49.99,
  "quantity": 1,
  "revenue_type": "subscription"
}

示例

这里有一些使用 Amplitude MCP 服务器与 Claude 实际操作的例子：

跟踪按钮点击

您：当用户点击提交按钮时，能否在 Amplitude 中跟踪该事件？

Claude：我将为您跟踪该事件。让我使用 Amplitude 分析工具。

[Claude 使用适当的参数调用 amplitude_track_event 工具]

Claude：我已经成功地在 Amplitude 中跟踪了带有您指定属性的 'button_clicked' 事件。

创建用户档案

您：在 Amplitude 中为 Sarah Johnson 创建一个新用户档案，她使用 sarah@example.com 注册了高级计划。

Claude：我将在 Amplitude 中创建那个用户档案。

[Claude 使用适当的参数调用 amplitude_track_signup 工具]

Claude：我已经成功地跟踪了 Sarah Johnson 的注册，并在 Amplitude 中创建了一个具有高级计划的档案。

跟踪收入

您：跟踪用户12345购买我们高级计划的 $99.99 收入。

Claude：我将在 Amplitude 中跟踪该收入事件。

[Claude 使用适当的参数调用 amplitude_track_revenue 工具]

Claude：我已经成功地跟踪了用户12345购买高级计划的 $99.99 收入。

故障排除

常见问题

  1. 服务器无法启动：

    • 确保您已提供了有效的 Amplitude API 密钥
    • 检查 Node.js 是否已安装且版本为 16 或更高

  2. Claude Desktop 不显示 Amplitude 工具：

    • 核实您的 claude_desktop_config.json 文件语法是否正确
    • 确保您在编辑配置后已重启 Claude Desktop
    • 检查到服务器的路径是否正确

  3. 事件未出现在 Amplitude 中：

    • 核实您的 Amplitude API 密钥是否正确
    • 检查您的 Amplitude 项目设置，确保数据已被接收
    • 事件可能需要几分钟时间才会出现在 Amplitude 界面中

调试模式

要在调试模式下运行服务器以获得更详细的日志：

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

安全注意事项

  • 您的 Amplitude API 密钥存储在 Claude Desktop 配置文件中。确保该文件具有适当的权限
  • 考虑在生产环境中使用环境变量来存储敏感令牌
  • 此服务器不实现速率限制 - 考虑为生产用途添加额外的安全措施
  • 事件直接发送到 Amplitude 的 API - 查阅 Amplitude 的隐私政策了解数据处理实践

贡献

欢迎贡献！请随意提交拉取请求。

  1. 分叉仓库
  2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add some amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

本项目采用 MIT 许可证 - 详情参见 LICENSE 文件。