PostHog监控平台

@PostHog/posthog-mcp

0 Stars 335 次浏览 PostHog 更新于 2026-08-23

一个模型上下文协议服务器，使 Claude Desktop 用户能够直接与 PostHog 互动，让他们通过自然语言命令查看项目和创建注释。

开发者工具

该服务暂未提供标准配置，请参考 README 手动接入

可用工具（2 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

list_posthog_projects List all available PostHog projects.

List all available PostHog projects.

该工具无需必填参数，直接调用即可

create_posthog_annotation 3 个参数需填 2 项 Create a PostHog annotation. Args: project_id: The ID of the project as an integer (e.g. 99423) content: The content/text of the annotation date_marker: Optional ISO-8601 timestamp for the annotation (e.g. 2024-03-20T14:15:22Z)

Create a PostHog annotation. Args: project_id: The ID of the project as an integer (e.g. 99423) content: The content/text of the annotation date_marker: Optional ISO-8601 timestamp for the annotation (e.g. 2024-03-20T14:15:22Z)

必填参数：project_id、content

服务介绍

PostHog MCP 服务器 📊

一个用于与 PostHog 交互的 Model Context Protocol (MCP) 服务器。通过 Claude Desktop 直接创建注释和管理项目！

功能 🚀

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

设置 🛠️

先决条件
- Python 3.10 或更高版本
- uv 包管理器
- 从项目设置获取具有 annotation:write 和 project:read 范围的 PostHog API 密钥

安装

# 克隆仓库
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 .

配置
- 在项目根目录下创建一个 .env 文件：
```
PERSONAL_API_KEY=phx_your_posthog_api_key_here
```
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 询问：

"List my PostHog projects"

获取和搜索洞察

向 Claude 询问：

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

在线搜索文档

您可以询问：

"如何在 nextjs 中为 posthog 设置反向代理？"

创建注释

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

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

或指定日期：

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

故障排除 🔍

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

贡献 🤝

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

查看源码项目主页

可用工具 （2 个）