posthog-mcp-server

PostHog MCP 服务

将 AI 助手连接到 PostHog —— 通过 Model Context Protocol 查询事件、用户、洞察、仪表板、功能标志、群组和实验。

适用于 Claude Desktop、Cursor、Windsurf、Cline、Continue 以及任何兼容 MCP 的客户端。

功能

工具	描述
list_events	按筛选条件查询事件（事件名称、用户、日期范围、属性）
get_person	按 distinct_id 获取用户——属性、创建日期、事件数量
list_persons	搜索并分页列出用户
list_dashboards	列出所有仪表板——名称、标签、组件数量
get_dashboard	获取指定仪表板及其洞察和组件
execute_insight	执行已保存的洞察（趋势、漏斗等）并获取结果
list_feature_flags	列出所有功能标志——键、启用状态、推出百分比
evaluate_feature_flag	为指定用户评估功能标志并获取变体值
list_cohorts	列出群组——名称、类型（动态/静态/SQL）、用户数量
list_experiments	列出 A/B 测试——名称、状态、功能标志、日期
get_experiment	获取实验结果，包括变体数据和统计显著性
list_actions	列出自定义事件操作/定义
get_project_info	获取项目名称、ID、设置和数据区域

快速开始

1. 获取 PostHog API 密钥

前往 PostHog → Settings → Personal API Keys 并创建一个具有读取权限的密钥。

或访问：https://your-instance.posthog.com/settings/user-api-keys

2. 配置 MCP 客户端

Claude Desktop —— 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "posthog-mcp-server"],
      "env": {
        "POSTHOG_API_KEY": "phx_YOUR_API_KEY_HERE",
        "POSTHOG_HOST": "https://us.i.posthog.com",
        "POSTHOG_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

Cursor —— 添加到 MCP 设置（.cursor/mcp.json）：

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "posthog-mcp-server"],
      "env": {
        "POSTHOG_API_KEY": "phx_YOUR_API_KEY_HERE",
        "POSTHOG_HOST": "https://us.i.posthog.com",
        "POSTHOG_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

3. 手动运行（用于测试）

# Clone and build
git clone https://github.com/friendlygeorge/posthog-mcp-server.git
cd posthog-mcp-server
npm install
npm run build

# Run
POSTHOG_API_KEY=phx_... POSTHOG_PROJECT=12345 node dist/index.js

环境变量

变量	必需	默认值	描述
POSTHOG_API_KEY	✅	—	你的 PostHog 个人 API 密钥（phx_...）
POSTHOG_HOST	❌	https://us.i.posthog.com	PostHog 实例 URL（欧盟地区请使用 https://eu.i.posthog.com）
POSTHOG_PROJECT	❌	""	默认项目 ID。若为空，必须在每次调用时指定。

可自托管的 PostHog

如果在自己的基础设施上运行 PostHog，请将 POSTHOG_HOST 设置为你的实例 URL：

POSTHOG_HOST=https://posthog.yourcompany.com

查询示例

配置完成后，可以向 AI 助手提问：

• “显示最近 20 条页面浏览事件”
• “本周最活跃的用户有哪些？”
• “我们的注册转化实验目前是什么状态？”
• “用户 abc123 是否启用了 new-checkout-flow 功能标志？”
• “显示所有启用的仪表板”
• “执行洞察 42 并显示趋势”
• “列出当前所有启用的功能标志”
• “‘Power Users’ 群组中有多少用户？”

API 参考

此服务封装了 PostHog REST API（v1）。完整文档：

• PostHog API 文档：https://posthog.com/docs/api
• MCP 协议：https://modelcontextprotocol.io
• PostHog：https://posthog.com

开发

npm install
npm run dev     # Build and run
npm run build   # Build only
npm start       # Run built output

许可证

MIT © Nova