项目简介

该项目是一个基于Model Context Protocol (MCP) 的服务器实现，专注于集成 Amplitude 分析平台。它使得大型语言模型 (LLM) 客户端能够通过标准化的MCP接口访问Amplitude的数据、执行操作（如事件追踪）以及利用预定义的分析Prompt模板。

主要功能点

• 事件追踪: 允许LLM通过调用工具向Amplitude发送用户事件。
• 用户分析: 提供工具获取特定用户的活动数据。
• 仪表板和队列管理: 能够列出并获取Amplitude中的仪表板和用户队列信息。
• 数据查询: 通过工具访问和查询Amplitude图表数据。
• 事件列表: 获取账户中所有已追踪事件类型的列表。
• 资源访问: 提供标准化的资源URI（如 'amplitude://dashboards'）供LLM直接读取仪表板、事件和队列列表。
• Prompt模板: 定义用于分析用户行为、创建仪表板等特定Amplitude任务的Prompt模板，帮助LLM更好地理解和执行复杂分析。

安装步骤

要安装此MCP服务器，您需要Python环境。打开终端或命令提示符，执行以下命令：

pip install mcp-amplitude

这将安装服务器及其所需的依赖项。

服务器配置

MCP服务器需要您的Amplitude API凭据才能连接到Amplitude服务。这些信息通常通过环境变量提供。

您需要设置以下环境变量：

• 'AMPLITUDE_API_KEY': 您的Amplitude API Key，用于大部分API请求。
• 'AMPLITUDE_SECRET_KEY': 您的Amplitude Secret Key，某些特定的API（如用户活动导出）需要此密钥。

您可以根据您的操作系统和环境设置这些变量。例如，在Linux/macOS Bash中：

export AMPLITUDE_API_KEY="您的API密钥"
export AMPLITUDE_SECRET_KEY="您的Secret密钥"

或在Windows Command Prompt中：

set AMPLITUDE_API_KEY="您的API密钥"
set AMPLITUDE_SECRET_KEY="您的Secret密钥"

或在Windows PowerShell中：

$env:AMPLITUDE_API_KEY="您的API密钥"
$env:AMPLITUDE_SECRET_KEY="您的Secret密钥"

MCP客户端配置: MCP服务器通常由MCP客户端（如某些LLM应用或框架）启动和管理。在您的MCP客户端配置中，您需要指定一个MCP服务器的入口。这通常包括：

• 服务器名称: 您为这个Amplitude服务器指定一个友好的名称（例如：'amplitude'）。
• 启动命令: 启动这个服务器的命令行指令，通常是 'mcp-amplitude'。
• 参数 (args): 此服务器目前不需要额外的命令行启动参数。
• 环境变量 (env): 在客户端配置中指定上面提到的 'AMPLITUDE_API_KEY' 和 'AMPLITUDE_SECRET_KEY' 环境变量，客户端启动服务器时会将其传递给服务器进程。

请参考您的MCP客户端的文档，了解如何添加和配置外部MCP服务器。您需要将服务器的启动命令 ('mcp-amplitude') 和您的Amplitude API凭据添加到客户端的配置中。

基本使用方法

安装并配置好环境变量后，您可以通过命令行直接启动服务器进行测试（尽管通常它由MCP客户端启动）：

mcp-amplitude

或者，如果您的环境使用了 'uvx' 这样的工具来启动MCP服务器：

uvx mcp-amplitude

服务器启动后，它会监听来自MCP客户端的JSON-RPC请求，并根据请求调用相应的工具、访问资源或渲染Prompt模板，与Amplitude进行交互。

用户主要通过支持MCP协议的LLM客户端来间接使用此服务器提供的功能。LLM会识别服务器的能力（工具、资源、Prompt），并在需要时自动调用它们来完成与Amplitude相关的任务。