What it does
Query events, funnels, retention and profiles in Pug product analytics, and build dashboards.
- Connects 在云端运行
- Account or key Sign in to the service when you connect (OAuth)
- Category 营销与社交媒体
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
为什么排在这里
此项在“连接 AI 的应用”标签中,该标签不使用星标,按以下顺序排列
| 1. 在 Claude 连接器目录中 | 否 | |
|---|---|---|
| 2. 团队实测过 | 否 | |
| 3. 适合泰国用户 | 否 | |
| 4. 不计星标的使用量 | 20/100 | 热度 0 · 新鲜度 12 · 仍在响应 8 · 用户喜欢 +0 |
| 5. 登记日期 | 2026-11-13 |
用户喜欢: 0 · 最多加 5 分(每人 1 分),不能用钱买。
质量: 基础检查通过 4/4 项(仅展示,不用于排序)
安装
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 Pug。按照 https://mcp.popnx.com/i/sh-pug-pug.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 4/4 项检查 · 你的提问会经过开发者的服务器(api.pug.sh) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
打开 Claude 的 Connectors 页面
CustomizeConnectors
点击“Add” → “Custom” → “Web”,填写这 2 项
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Name · 名称PugRemote MCP server URL · 地址https://api.pug.sh/mcp在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
在聊天中开启
+ConnectorsPug
试一试
用 Pug 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Pug,或回答中出现 Pug 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
能否连接 ChatGPT 取决于方案
完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页
在网页版 ChatGPT 打开添加 MCP 的页面
Plugins+Add custom MCP server
填写名称和地址
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
Name · 名称PugConnection · 地址https://api.pug.sh/mcp在聊天中选择 Pug
开启新聊天,输入前先从插件列表中选择 Pug
试一试
用 Pug 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 Pug,或回答中出现 Pug 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --transport http --scope user pug https://api.pug.sh/mcp在 Claude Code 中输入 /mcp
应能看到 Pug 在列表中并显示已连接
试一试
用 Pug 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Pug,或回答中出现 Pug 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Pug 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Pug,或回答中出现 Pug 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Pug 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Pug,或回答中出现 Pug 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://api.pug.sh/mcpJSON 设置在下方“开发者专用”中
开发者专用:终端命令和 JSON 设置
通过网页连接
Claude Code
claude mcp add --transport http --scope user pug https://api.pug.sh/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"pug": {
"url": "https://api.pug.sh/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"pug": {
"type": "http",
"url": "https://api.pug.sh/mcp"
}
}
}这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
它能做什么
服务器要求先登录,才会列出它的工具。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 pug.sh 验证(注册中心会核实域名所有权)
- ✓ 通过
仍在维护
代码最后更新于昨天
- – 不适用
有许可证
不适用:由 pug.sh 的所有者自己运行的云端服务器,你不会运行仓库里的代码
- ✓ 通过
端点有响应
在 586 毫秒内响应(HTTP 401)
- ✓ 通过
使用 OAuth 登录
声明支持 OAuth 登录,你的 AI 应用可以带你去登录
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
云端地址最近 4 次检查中有 4 次响应 · 最近一次 586 ms · 检查于 2026年11月18日
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/sh-pug-pug)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“营销与社交媒体”中的其他服务器比较i
- 星标数多于此分类中其他 4159 个服务器的 99%
- 发布到注册中心的时间比此分类中其他 4159 个服务器的 86% 更新
- 基础检查结果等于或优于此分类中其他 4159 个服务器的 99%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Pug 安全吗?
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于昨天,最新版本(0.0.56)于6天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
有什么可以替代它?
同一分类中有:Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| 本项 Pug | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| 运行位置 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 |
| 需要密钥 | 否 | 否 | 否 | 否 | 是 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 否 | 否 |
| 基础检查 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| 许可证 | AGPL-3.0 | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Pug
Pug is an open-source product analytics platform. Capture events, identify the people behind them, and explore behavior through funnels, retention, trends, segmentation, and user-flow analysis, all surfaced on customizable dashboards.
Built in Go on PostgreSQL, ClickHouse, and NATS.
Features
- Event ingestion: a NATS-backed capture pipeline with automatic geo, user-agent, bot-detection, and web-attribution enrichment.
- Web analytics: an overview auto-built from your events: visitors, sessions, pageviews, bounce rate, and traffic sources, with no tile to wire up.
- Live view: every visitor on a real-time world map, down to the person and the event they just fired.
- Profiles: identify and alias the users behind events, with a ClickHouse-backed profile and activity API.
- Insights: trends, funnels, retention, segmentation, user flow (Sankey), and top-K breakdowns, with filtering, breakdowns, and period-over-period comparison.
- Dashboards: compose insight and markdown tiles on a grid with a board-level time window, accelerated by a pre-aggregated rollup fast path.
- MCP server: Claude, ChatGPT, or any MCP client can query your insights, events, and profiles, and build dashboards for you.
- Privacy & compliance: GDPR/DPDP data-subject erasure of a person's events and profile.
Overview : a web-analytics view auto-built from your events, with the previous period alongside.
Breakdowns : pageviews by country, plus locations, devices, and events; click any value to filter the whole view.
Live view : every visitor on a live world map; click one to fly to them and see the page, device, and profile behind it.
Events : every raw event as it lands, with its location, platform, properties, and the person behind it.
Dashboards : compose insight and markdown tiles on a time-windowed grid.
Insights : trends, filters, and breakdowns; here product views split by country.
Funnels : step-by-step conversion; here product view to purchase.
Profiles : the person behind the events, with traits, sessions, and activity.
MCP server
Pug serves a Model Context Protocol server, so an AI assistant can query your analytics. Sixteen tools read projects, dashboards, insights, events, sessions, and profiles, and one creates and edits dashboards.
| Environment | Endpoint |
|---|---|
| Pug Cloud | https://api.pug.sh/mcp |
| Self-hosted | /mcp on your API host, e.g. http://localhost:3000/mcp |
In Claude, add Pug from the connectors directory. Other clients take the endpoint as a custom connector. Connect by signing in to Pug, or with a project's private (prv_) API key in the x-api-key header. A self-hosted server offers sign-in only once PUG_API_BASE_URL is set. Setup steps for each client are in the MCP docs.
Tech stack
- Go: backend services and workers, exposed over Connect RPC (HTTP/2)
- PostgreSQL: relational store (orgs, projects, dashboards, auth)
- ClickHouse: analytical store for events, insights, and profiles
- NATS: messaging backbone for the ingestion and worker pipelines
Self-hosting
See the self-hosting guide. A Pug instance is this repo's backend, published as container images on ghcr.io/pug-sh, plus the dashboard from pug-sh/app, served as static files.
Quick start
# Build the binary into bin/pug
make build
Start dev infrastructure (PostgreSQL, NATS, ClickHouse)
make infra
Run migrations (Postgres, NATS, ClickHouse)
./bin/pug migrate
Seed the demo project with events, profiles, and dashboards
(resets the local Postgres and ClickHouse databases; see "Demo data" below)
./bin/pug seed
Start the dev server + workers together
./bin/pug dev
docs/development.md walks through each step, including signing in as the demo org's admin.
Environment variables are documented in .env.example. Google and generic OIDC sign-in are documented in docs/authentication.md, with a ready-to-copy config.example.json.
Demo data
./bin/pug seed fills a "Pug & Pals" demo project with ~6 months of history, so dashboards, insights, and profiles have something to show. Profiles are seeded only for users that produced events, so the data is internally consistent.
Local databases only. By default
seedmigrates Postgres and ClickHouse
all the way down and back up, dropping every table, not just the demo rows.
There is no confirmation prompt and no environment check: it connects to
whatever
DATABASE_URLandCLICKHOUSE_URLresolve to, and an already
exported variable beats
.env. Point it at a disposable local or demo
database.
Pass --no-reset to keep the schema; it then deletes the demo project's own events and profiles before re-seeding them, leaving other projects untouched. Volume is tunable with --count (default 500,000 events) and --batch (default 10,000 events per insert). Run it from the repo root; it reads the same .env as the rest of the CLI.
Two read-only accounts are seeded, plus an admin if you ask for one:
woof@pug.showns the demo org and its data. It has no password.snoop@pug.shis a viewer with no password; open/demowithPUG_DEMO_ENABLED=trueto sign in as it.admin@pug.exampleis the demo org's admin, seeded only whenPUG_DEMO_ADMIN_PASSWORDis set (16 characters to 72 bytes, no surrounding whitespace), with that password. The address can't receive mail. Nothing logs the password, and later runs never change it, so change it in the dashboard, to 16 characters or more, and update the variable to match, since the seeder restores the admin's role only while they match. A defaultpug seedresets the database, though, and so recreates the admin from the current value.
For a live stream of traffic instead of a one-shot backfill, set PUG_DEMO_ENABLED=true: ./bin/pug dev then also runs the demo worker. It backfills an empty project once, so after pug seed it skips straight to playing new sessions out in real time. If you seed with a smaller --count, lower PUG_DEMO_SEED_COUNT to match: the worker reads a project holding fewer events than that as an interrupted backfill and warns rather than topping it up.
Development
make test # run tests (race detector enabled)
make cover # run tests and write coverage.out make lint # lint Go code make sqlc # regenerate sqlc queries after editing SQL make rpc # regenerate protobuf code after editing .proto files make templ # regenerate templ email templates
Architecture
Per-subsystem documentation lives in docs/architecture/ (insights, ClickHouse, profiles, ingestion, email, telemetry). Contributor guidance and conventions are in CLAUDE.md.
License
Copyright (C) 2025 pug.sh contributors.
Pug is licensed under the GNU AGPL v3.0, or (at your option) any later version. Contributors sign a CLA before their first pull request is merged; see CONTRIBUTING.md.