关于 convalytics
Convalytics 为 Convex 应用提供网页分析和产品事件追踪,并将数据汇总到一个仪表板。它面向需要查看访问行为和应用内事件的 Convex 项目,也提供 CLI 进行项目初始化。
主要功能
- 01采集页面浏览、会话和跳出率
- 02分析来源及设备、浏览器信息
- 03从 Convex mutations 和 actions 跟踪事件
- 04通过 CLI 初始化项目与分析配置
适用场景
- 01查看 Convex 应用的访问与流量来源
- 02追踪注册、付款和功能使用事件
MCP 相关
README 提到可通过 MCP 从 Claude、Cursor 等客户端查询只读分析数据,但未列出具体 MCP 工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://api.convalytics.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http dan-cleary-convalytics https://api.convalytics.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"dan-cleary-convalytics":{"type":"http","url":"https://api.convalytics.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"dan-cleary-convalytics":{"serverUrl":"https://api.convalytics.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://api.convalytics.dev/mcp需要授权工具
15此工具无需参数。
详细介绍
Convalytics
专为 Convex 应用打造的 Web 分析和产品事件追踪。
仪表板: convalytics.dev
Convalytics 是什么?
Convalytics 为 Convex 应用提供两项功能:
- Web 分析 — 通过轻量级脚本标签自动追踪页面浏览量、会话、跳出率、引荐来源,以及设备和浏览器细分数据。
- 产品事件追踪 — 直接从 Convex mutations 和 actions 中追踪注册、付款、功能使用情况及任何自定义事件。服务端事件无法被广告拦截器屏蔽。
所有数据都会汇入同一个仪表板。项目会在收到首个事件时自动创建,无需账户即可开始追踪。
快速开始
npx convalytics init
此命令会自动创建项目、安装 Convex 组件、修改 convex/convex.config.ts、创建内嵌写入密钥的 convex/analytics.ts、将浏览器脚本标签插入 index.html,并为 AI Agent 安装技能文件。开箱即用,支持 Cursor、Claude Code 和其他 AI 编码 Agent。
软件包
| 软件包 | 描述 |
|---|---|
convalytics-dev | 用于服务端事件追踪的 Convex 组件 |
convalytics | 用于零配置项目设置的 CLI |
项目结构
convalytics/
convex/ # Convex backend — dashboard API, ingest, billing, auth
src/ # React frontend — dashboard UI
cli/ # CLI (published as convalytics on npm)
Convex 组件(npm 上的 convalytics-dev)位于独立仓库中:
Dan-Cleary/convalytics-convex-component
技术栈
- 后端: Convex — 数据库、服务端函数、定时任务、实时查询
- 前端: React 19、React Router v7、TailwindCSS v4、Vite、Recharts
- 托管: Vercel(前端)、Convex Cloud(后端)
- 计费: Stripe(基于用量的套餐)
- 电子邮件: Resend + React Email
开发
npm install
npm run dev
此命令会并行启动 Vite 前端和 convex dev。
链接
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。