Liquidium MCP 服务器

通过 Liquidium 与 PostHog 分析进行交互的 Model Context Protocol (MCP) 服务器。直接通过 Claude Desktop 或 Smithery 创建注释和管理项目！

功能

• 列出项目：查看组织中所有可用的 PostHog 项目
• 创建注释：为您的 PostHog 项目添加带有可选时间戳的注释
• 列出和搜索洞察：查看和搜索您的 PostHog 项目中的洞察
• 获取洞察详情：查看特定洞察的详细信息

设置

选项 1：Smithery（推荐）

使用 Liquidium MCP 的最简单方法是通过 Smithery：

1. 访问 Smithery 上的 Liquidium MCP
2. 点击“添加到 Claude”
3. 在提示时输入您的 PostHog API 密钥
4. 开始在 Claude 中使用 Liquidium 工具！

选项 2：本地安装

1. 前提条件

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

2. 安装

   # 克隆仓库
   git clone https://github.com/Shudufhadzo/liquidium-mcp.git
   
   cd liquidium-mcp
   
   # 创建并激活虚拟环境
   python -m venv .venv
   
   # 在 Windows 上
   .venv\Scripts\activate
   
   # 在 macOS/Linux 上
   source .venv/bin/activate
   
   # 安装依赖项
   pip install -e .
   

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/python",  // 通过运行：which python 获取
           "args": [
             "-m",
             "posthog_mcp",
             "--directory",
             "/path/to/your/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的贡献指南。