PostHog MCP 服务器 📊

一个用于与 PostHog 交互的模型上下文协议 (MCP) 服务器。直接通过 Claude Desktop 创建注释和管理项目！

功能 🚀

• 列出项目: 查看您组织中所有可用的 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 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 项目"

获取和搜索 Insights

询问 Claude：

"列出我的 PostHog insights" 或 "在我的 PostHog 中搜索收入 insights"

在线搜索文档

您可以问：

• "如何在 posthog 的 nextjs 中进行反向代理？"

创建注释

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

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

或者使用特定日期：

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

故障排除 🔍

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

贡献 🤝

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