项目简介

这是一个基于 Model Context Protocol (MCP) 实现的应用后端服务器，旨在将 PostHog 分析平台的特定功能暴露给支持 MCP 的大型语言模型 (LLM) 客户端，例如 Claude Desktop。用户可以通过与 LLM 自然语言交互，直接在 PostHog 中执行操作。

主要功能点

• 列出项目: 查看您的 PostHog 组织下所有可用的项目列表。
• 创建注解: 在指定的 PostHog 项目中添加文本注解，可选是否指定具体日期和时间。
• 列出与搜索分析洞察: 查看或根据名称搜索 PostHog 项目中的分析洞察 (Insights) 列表。
• 获取分析洞察详情: 查看特定分析洞察的详细信息。
• 搜索文档: 搜索 PostHog 相关的在线文档。

安装步骤

1. 前置条件: 确保已安装 Python 3.10 或更高版本，以及 'pip' 或 'uv' 包管理器。您还需要一个具备 'annotation:write' 和 'project:read' 权限的 PostHog API Key。
2. 克隆仓库: 从 GitHub 克隆项目代码。
3. 创建并激活虚拟环境: 使用 Python 的 'venv' 创建并激活一个虚拟环境，以隔离项目依赖。
4. 安装依赖: 在激活的虚拟环境中，使用 'pip install -e .' 安装项目及其依赖。
5. 配置 API Key: 在项目根目录创建一个 '.env' 文件，并在其中添加您的 PostHog API Key，例如：'PERSONAL_API_KEY=phx_your_posthog_api_key_here'。

MCP 服务器配置 (面向 MCP 客户端)

将此服务器集成到 MCP 客户端（如 Claude Desktop）中，您需要在客户端的配置中添加一个 MCP 服务器条目。通常，这涉及编辑一个 JSON 配置文件，并指定服务器的启动命令及其参数。

需要配置的关键信息如下：

• 服务器名称 (server name): 一个唯一的标识符，例如 'posthog'。
• 命令 (command): 启动 MCP 服务器的可执行文件路径。通常是您的 Python 解释器路径。
• 参数 (args): 传递给命令的参数列表。对于此项目，参数通常是 '-m', 'posthog_mcp', '--directory', 后面跟着项目的完整路径。

请参考您的 MCP 客户端文档以获取具体的配置文件的位置和格式细节，并根据您系统的实际情况填写命令和项目路径。

基本使用方法

配置完成后，在支持 MCP 的 LLM 客户端中，您会看到表示可用工具的图标。您可以通过向 LLM 发出自然语言指令来使用 PostHog 功能：

• 询问 LLM：“列出我的 PostHog 项目”
• 询问 LLM：“创建一条 PostHog 注解 在项目 53497 说 '部署了 v1.2.3'”
• 询问 LLM：“列出我的 PostHog 分析洞察” 或 “搜索关于收入的 PostHog 分析洞察”
• 询问 LLM：“PostHog 中如何配置反向代理” (搜索文档)