使用说明

项目简介

PostHog MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 PostHog 的数据分析能力与 Claude Desktop 等大型语言模型 (LLM) 客户端连接起来。通过此服务器，用户可以直接在 Claude 中访问和操作 PostHog 项目及注释，例如列出项目、创建项目注释等，从而提升数据分析和工作流程的效率。

主要功能点

列出PostHog项目: 允许用户通过 Claude 快速查看其 PostHog 组织下的所有项目。
创建PostHog注释: 支持用户在 Claude 中直接为 PostHog 项目创建注释，方便记录事件、部署等重要信息。

安装步骤

环境准备:
- 确保已安装 Python 3.10 或更高版本。
- 安装 'uv' 包管理器。
- 确保拥有 PostHog API Key，并已在 PostHog 项目设置中为此 API Key 启用 'annotation:write' 和 'project:read' 权限。

下载仓库:

git clone https://github.com/PostHog/posthog-mcp.git
cd posthog-mcp

创建虚拟环境并安装依赖:

uv venv
source .venv/bin/activate  # 或 .venv\Scripts\activate (Windows)
uv pip install .

配置API Key:

将您的 PostHog Personal API Key 填入 '.env' 文件，例如：

PERSONAL_API_KEY=phx_your_posthog_api_key_here

服务器配置

要将此 MCP 服务器与 Claude Desktop 客户端连接，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

打开 Claude Desktop 设置，点击 "Edit Config" (编辑配置)。

在打开的 'claude_desktop_config.json' 文件中，找到 '"mcpServers"' 部分，并添加以下配置信息。如果不存在 '"mcpServers"' 部分，请手动创建。

{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",  // 请替换为 uv 的完整路径，例如 /usr/local/bin/uv 或 C:\Users\YourName\.venv\Scripts\uv
      "args": [
        "--directory",
        "/path/to/your/posthog-mcp",  // 请替换为 posthog-mcp 项目的完整路径，例如 /Users/YourName/posthog-mcp 或 C:\Users\YourName\Documents\posthog-mcp
        "run",
        "posthog.py"
      ]
    }
  }
}

参数说明:

'"posthog"': 服务器名称，您可以自定义，在 Claude 中用于标识此服务器。
'"command"': 'uv' 包管理器的可执行文件路径。您可以通过在终端运行 'which uv' (macOS/Linux) 或 'where uv' (Windows) 命令来查找 'uv' 的完整路径。
'"args"': 启动服务器的参数列表。
- '"--directory"': 指定 MCP 服务器代码所在的目录，即 'posthog-mcp' 项目的根目录的完整路径。
- '"run"': 'uv' 命令的子命令，用于运行 Python 脚本。
- '"posthog.py"': 要运行的 Python 脚本文件名，即 MCP 服务器的主程序文件。

保存 'claude_desktop_config.json' 文件。

基本使用方法

配置完成后，重启 Claude Desktop。您应该会在 Claude Desktop 界面中看到一个锤子 🔨 图标，表示 MCP 服务器已成功加载。

现在，您可以使用以下指令与 Claude 交互，操作 PostHog 数据：

列出项目: 在 Claude 中输入指令，例如：

"列出我的 PostHog 项目"
"List my PostHog projects"

Claude 将调用 MCP 服务器，并返回您的 PostHog 项目列表。

创建注释: 使用从项目列表中获取的项目 ID，在 Claude 中输入指令，例如：

"在项目 53497 中创建一个 PostHog 注释，内容为 '已部署 v1.2.3'"
"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

或指定日期：

"在项目 53497 中为 3 月 20 日创建一个 PostHog 注释，内容为 '启动新的营销活动'"
"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

Claude 将调用 MCP 服务器，在指定的 PostHog 项目中创建注释，并返回创建结果。

请参考仓库 README 文件获取更多使用示例和问题排查信息。

关键词