🚀 PostHog MCP 服务器 📊

PostHog MCP 服务器是一个用于与 PostHog 交互的模型上下文协议 (MCP) 服务器。借助它，你可以通过 Claude Desktop 直接创建注释并管理项目，为项目管理带来极大便利。

🚀 快速开始

PostHog MCP 服务器能让你通过 Claude Desktop 与 PostHog 进行交互，实现项目管理和注释创建等功能。完成安装和配置后，即可在 Claude Desktop 中使用相关命令操作 PostHog。

✨ 主要特性

• 列出项目：可查看您组织中所有可用的 PostHog 项目。
• 创建注释：能向您的 PostHog 项目添加注释，还可选择带有时间戳。 [此列表还可以更长，基本上我们 API 提供的所有功能...]

📦 安装指南

1. 先决条件

• Python 3.10 或更高版本。
• uv 包管理器。
• 具备 annotation:write 和 project:read 权限的 PostHog API Key，可从您的 项目设置 获取。

2. 安装

# 克隆仓库
git clone git@github.com:PostHog/posthog-mcp.git

# 或者使用 https：git clone https://github.com/PostHog/posthog-mcp.git

cd posthog-mcp

uv venv
source .venv/bin/activate

# 安装依赖项
uv pip install .

3. 配置

在项目根目录创建一个 .env 文件：

PERSONAL_API_KEY=phx_your_posthog_api_key_here

4. Claude Desktop 设置

• 安装 Claude Desktop。
• 打开 Claude Desktop 设置并点击“编辑配置”。或者，您可以通过以下路径打开文件：
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
• 将其添加到您的 claude_desktop_config.json（根据您的系统调整路径）：

{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",  # 通过运行：which uv 获取此路径
      "args": [
        "--directory",
        "/path/to/your/posthog-mcp",  # 此项目的完整路径
        "run",
        "posthog_mcp"
      ]
    }
  }
}

查看 最新文档，了解如何设置 Claude Desktop 作为 MCP 客户端，如果您遇到任何问题。

💻 使用示例

完成安装后，您会在 Claude Desktop 中看到一个锤子 🔨 图标。以下是一些可用命令：

基础用法

列出项目

请 Claude 执行：

"列出我的 PostHog 项目"

创建注释

使用从项目列表中获得的项目 ID，请 Claude 执行：

"在项目 53497 中创建一条 PostHog 注释，内容为 '部署了 v1.2.3'"

高级用法

获取和搜索见解

请 Claude 执行： "列出我的 PostHog 见解" 或 "在 PostHog 中搜索收入见解"

在线搜索文档

您可以询问：

• "如何在 Nextjs 中为 PostHog 设置反向代理？"

创建带日期的注释

指定日期创建注释：

"在项目 53497 中于 3月20日 创建一条注释，内容为 '启动新的营销活动'"

📚 详细文档

故障排除

• 如果锤子图标未出现，请重启 Claude Desktop。
• 检查日志路径：~/Library/Logs/Claude/mcp*.log（macOS）或 %APPDATA%\Claude\logs（Windows）。
• 确保您的 PostHog API Key 具有正确的权限。
• 确保 claude_desktop_config.json 中的所有路径都是绝对路径。

贡献

随意提出问题和 PR！我们遵循 PostHog 的贡献指南。