# @arvoretech/posthog-mcp 中文文档

规范地址：https://npmcn.com/package/%40arvoretech/posthog-mcp/

版本：1\.0\.1
npm 元数据更新时间：2026-06-16T21:13:23.972Z
中文译文更新时间：2026-11-06T21:41:51.486Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40arvoretech/posthog-mcp
原文对照：https://npmcn.com/package/%40arvoretech/posthog-mcp/?lang=original
项目主页：https://github.com/arvoreeducacao/arvore-mcp-servers#readme
源码仓库：https://github.com/arvoreeducacao/arvore-mcp-servers

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：64.9 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-04-28T20:34:39.332Z
- 最新版本发布：2026-05-11T15:11:10.565Z
- 近 30 天下载量：2435（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

后霍克 MCP 软件 用于分析、特征标记、实验、误差跟踪和更多(自办兼容)的服务器

## 安装

```sh
npm install @arvoretech/posthog-mcp
```

也可以使用：`pnpm add @arvoretech/posthog-mcp`、`yarn add @arvoretech/posthog-mcp`、`bun add @arvoretech/posthog-mcp`

## README

# PostHog MCP 服务器

一个用于PostHog的模型上下文协议(MCP)服务器,提供解析,特征旗帜,实验,仪表板等访问权限. 与PostHog Cloud和自办公司合作.

## 特征

-   **分析**:运行HogQL查询和结构化查询(趋势、漏斗、保留、寿命周期、路径、粘性)
-   **特性旗**: 创建、更新、列表并删除带有推出控制的特性标记
-   **实验**: 列出并检查具有变体和度量的A/B试验试验
-   **磁盘板和透视**: 创建、列出和检查仪表板并保存见解
-   **事件属性( P)**: 探索事件定义和财产定义
-   **个人和组合**: 搜索用户并管理部分
-   **调查和早期获取**: 清单调查和早期访问功能
-   **说明**: 创建和列出部署和事件的图表说明
-   **搜索**: 搜索所有 PostHog 实体
-   **自我拥有**: 与静态证书直接连接的API——不需要OAuth
-   **类型脚本**: 用 Zod 验证完全输入

## 安装

```bash
npm install -g @arvoretech/posthog-mcp
```

## 配置

服务器通过环境变量配置 :

```bash
export POSTHOG_BASE_URL=https://posthog.example.com  # or https://app.posthog.com
export POSTHOG_API_KEY=phx_your_personal_api_key
export POSTHOG_PROJECT_ID=1                           # optional, defaults to 1
```

### 获取您的 API 密钥

1.  转到 PostHog 设置 个人 API 密钥
2.  点击“ 创建个人 API 密钥 ”
3.  选择您需要的范围( 或如果可用的话使用“ MCP 服务器”)
4.  复制生成的密钥( 启动于 `phx_`(中文(简体) )

## 使用量

```bash
# Development
pnpm dev

# Production
node dist/index.js
```

## 可用的 MCP 工具

### 特性旗

| 工具 | 说明 |
| --- | --- |
| `list_feature_flags` | 列出带有搜索和页标的所有特征标记 |
| `get_feature_flag` | 用 ID 获取特定旗帜的细节 |
| `create_feature_flag` | 创建带有可选推出百分比的新旗帜 |
| `update_feature_flag` | 更新旗帜密钥、 名称或活动状态 |
| `delete_feature_flag` | 用 ID 删除特性旗 |

### 实验

| 工具 | 说明 |
| --- | --- |
| `list_experiments` | 列出所有 A/B 试验 |
| `get_experiment` | 获得包括变体和计量的实验细节 |

### 透视与分析

| 工具 | 说明 |
| --- | --- |
| `list_insights` | 列出保存的见解(趋势、漏斗、保留等) |
| `get_insight` | 通过身份识别获得具体见解 |
| `create_insight` | 在仪表板上创建新的洞察力并选择添加 |
| `execute_sql` | 执行针对 PostHog 数据的 HogQL 查询 |
| `execute_query` | 运行结构化查询( TrendsQuery, FunnelsQuery, ReleaseQuery等) |

### 盘子

| 工具 | 说明 |
| --- | --- |
| `list_dashboards` | 列出所有可选择搜索的仪表板 |
| `get_dashboard` | 获得包括瓷砖在内的仪表板细节 |

### 事件属性( P)

| 工具 | 说明 |
| --- | --- |
| `list_event_definitions` | 列出所有跟踪事件类型 |
| `list_property_definitions` | 列表事件或个人财产定义 |

### 个人和组合

| 工具 | 说明 |
| --- | --- |
| `list_persons` | 通过电子邮件、名称或识别身份搜索用户 |
| `list_cohorts` | 列出所有组( 用户段) |

### 说明

| 工具 | 说明 |
| --- | --- |
| `list_annotations` | 列出所有图表注释 |
| `create_annotation` | 创建新注释标记 |

### 调查和早期获取

| 工具 | 说明 |
| --- | --- |
| `list_surveys` | 列出所有调查 |
| `list_early_access_features` | 列出早期访问功能 |

### 组织搜索( S)

| 工具 | 说明 |
| --- | --- |
| `list_projects` | 列出当前 API 密钥的所有工程 |
| `search` | 搜索所有 PostHog 实体 |

## HogQL 示例

过去7天的每日活动计数:

```sql
SELECT toDate(timestamp) as day, count() as events
FROM events
WHERE timestamp > now() - INTERVAL 7 DAY
GROUP BY day ORDER BY day
```

浏览器独有的用户 :

```sql
SELECT properties.$browser as browser, uniq(distinct_id) as users
FROM events
WHERE event = 'pageview' AND timestamp > now() - INTERVAL 30 DAY
GROUP BY browser ORDER BY users DESC
```

日常活动用户 :

```sql
SELECT toDate(timestamp) as day, uniq(distinct_id) as dau
FROM events
WHERE timestamp > now() - INTERVAL 30 DAY
GROUP BY day ORDER BY day
```

## 程序用途

```typescript
import { PostHogMCPServer } from "@arvoretech/posthog-mcp";

const server = new PostHogMCPServer({
  baseUrl: "https://posthog.example.com",
  apiKey: "phx_your_key",
  projectId: "1",
});

server.setupGracefulShutdown();
await server.start();
```

## Claude 桌面/ Kiro 集成

```json
{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "@arvoretech/posthog-mcp"],
      "env": {
        "POSTHOG_BASE_URL": "https://posthog.example.com",
        "POSTHOG_API_KEY": "phx_your_personal_api_key"
      }
    }
  }
}
```

## 发展

```bash
pnpm install
pnpm dev
pnpm build
pnpm lint
```

## 限制

-   只有地铁运输(无HTTP/WebSocket)
-   HogQL 查询按设计只读( PostHog API 限制)
-   需要个人 API 密钥( X)`phx_` 前缀,不是工程 API 密钥

## 常见问题

### @arvoretech/posthog-mcp 是什么？

后霍克 MCP 软件 用于分析、特征标记、实验、误差跟踪和更多\(自办兼容\)的服务器

### 如何安装 @arvoretech/posthog-mcp？

在项目目录运行 npm install @arvoretech/posthog-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 posthog-mcp，可以用 npx posthog-mcp 直接运行。

### @arvoretech/posthog-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @arvoretech/posthog-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @arvoretech/posthog-mcp 可以商用吗？

@arvoretech/posthog-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @arvoretech/posthog-mcp 的下载量有多少？

根据 npm 官方下载统计，@arvoretech/posthog-mcp 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,435 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @arvoretech/posthog-mcp 还在维护吗？

最新版本 1\.0\.1 发布于 2026/05/11（5 个月前）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/04/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。