内容
# posthog-code-mode-mcp
一款适用于 [PostHog](https://posthog.com/) 的精简 [MCP](https://modelcontextprotocol.io/) 服务器,用单个工具取代了默认的约 70k token 的 PostHog MCP 服务器。
灵感来自 Cloudflare 的 [code mode](https://blog.cloudflare.com/code-mode/) 模式:不是暴露数十个独立的工具(每个 API 端点一个),而是暴露一个单独的 `posthog` 工具,它在沙盒 VM 中执行 JavaScript 代码,并带有类型化的 PostHog API 客户端。
## 为什么?
官方 PostHog MCP 服务器附带约 70k token 的工具定义。这在您甚至还没提出问题之前就已经占用了大量上下文窗口。通过让 LLM 编写针对类型化客户端的代码,这个服务器使用单个工具定义(约 2k token)实现了相同的覆盖范围。
## 设置
### 1. 安装依赖
```bash
npm install
```
### 2. 配置环境
复制示例并填写您的值:
```bash
cp .env.example .env
```
```
POSTHOG_API_KEY=phx_您的个人API密钥
POSTHOG_PROJECT_ID=12345
```
- **API 密钥**:在 https://us.posthog.com/settings/user-api-keys 创建个人 API 密钥
- **项目 ID**:在 PostHog 项目设置 URL 中找到您的项目 ID
### 3. 添加到 Claude Code
将以下内容添加到您的 Claude Code MCP 配置(`~/.claude/settings.json` 或项目级):
```json
{
"mcpServers": {
"posthog-code-mode": {
"command": "node",
"args": ["/path/to/posthog-code-mode/index.js"],
"env": {
"POSTHOG_API_KEY": "phx_您的密钥",
"POSTHOG_PROJECT_ID": "12345"
}
}
}
}
```
或者,如果使用 `.env` 文件,请指向目录并加载环境变量。
## 使用
服务器暴露一个单独的 `posthog` 工具。LLM 编写的 JavaScript 代码在沙盒 VM 中运行,带有全局可用的 `posthog` 客户端对象。
### 示例
**按类型统计事件(最近 7 天):**
```js
const result = await posthog.query({
kind: "HogQLQuery",
query: "SELECT event, count() FROM events WHERE timestamp > now() - interval 7 day GROUP BY event ORDER BY count() DESC LIMIT 20"
});
console.log(result.results);
```
**列出功能标志:**
```js
const flags = await posthog.featureFlags.list({ limit: 50 });
console.log(flags.results.map(f => ({ key: f.key, active: f.active })));
```
**为任意端点使用逃生口:**
```js
const result = await posthog.api("GET", "/session_recordings", { limit: 5 });
console.log(result.results);
```
## API 覆盖范围
`posthog` 客户端提供以下类型的接口:
- **HogQL 查询** — `posthog.query()`
- **洞察** — CRUD
- **仪表板** — CRUD
- **事件** — 列表
- **人员** — 列表,获取
- **功能标志** — CRUD
- **实验** — CRUD + 结果
- **群体** — CRUD
- **注释** — 列表,获取,创建
- **操作** — CRUD
- **调查** — CRUD
- **错误跟踪** — 列表,获取,更新
- **逃生口** — `posthog.api(method, path, body)` 用于上述未涵盖的任意端点
## 许可证
ISC