🚀 PostHog MCP 服务器 📊

这是一个与 PostHog 交互的模型上下文协议（MCP）服务器。借助它，你可以通过 Claude 桌面直接创建注释并管理项目！

🚀 快速开始

PostHog MCP 服务器能让你通过 Claude 桌面与 PostHog 进行交互。完成安装和配置后，即可在 Claude 桌面使用相关功能。

✨ 主要特性

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

📦 安装指南

安装前准备

1. 先决条件

   • 需要 Python 3.10 或更高版本。
   • 安装 uv 包管理器。
   • 在您的 项目设置 中获取具有 annotation:write 和 project:read 权限的 PostHog API 密钥。

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 桌面设置

   • 安装 Claude 桌面。
   • 打开 Claude 桌面设置，点击“编辑配置”。或者可以直接打开文件：
     • 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 桌面作为 MCP 客户端时遇到问题，可查看 最新文档。

💻 使用示例

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

基础用法

列出项目

询问 Claude：

"列出我的 PostHog 项目"

创建注释

使用从项目列表中获得的项目 ID，询问 Claude：

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

高级用法

获取和搜索见解

询问 Claude： "列出我的 PostHog 见解" 或 "在 PostHog 中搜索收入见解"

在线搜索文档

您可以询问：

• "如何在 Next.js 中使用反向代理在 PostHog 中？"

创建带日期的注释

指定具体日期，询问 Claude：

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

🔍 故障排除

• 如果锤子图标未出现，请重启 Claude 桌面。
• 检查日志路径：~/Library/Logs/Claude/mcp*.log（macOS）或 %APPDATA%\Claude\logs（Windows）。
• 确保 API 密钥具有正确的权限。

⚠️ 重要提示

使用前请确保已正确设置环境变量，并检查网络连接。