prufa-mcp 是 Prufa 提供的开源 MCP 服务器，定位为“面向 vibe-coded 应用的 QA 智能体”，采用 Apache-2.0 许可。它的目标是解决这类应用发布速度快于人工审查、从而在首日就带着严重缺陷上线的问题。用户把一个 URL 交给它，它就会审计人们在快速迭代时容易忽略的环节，并给出机器验证的发现结果，按 A–F 分级。
【用途】 对指定 URL 执行真实浏览器 QA 审计，覆盖：损坏的注册、登录与结账流程，JS 控制台错误，分析追踪未触发，同意（consent）横幅失效，安全响应头缺失，移动端点击目标，无障碍等。审计结果面向编码智能体输出，便于在开发过程中尽早发现回归问题。
【主要能力】 审计结果是一个 JSON 报告，发现项按分级分区组织，每条包含严重程度、影响（为什么重要）以及修复提示。报告还包含 report_url，即同一报告的可分享 HTML 版本。完整负载还包含 tracking、consent、seo / aeo、a11y、forms 以及检测到的用户流程等部分。prufa-mcp 通过 MCP 暴露整个产品共 44 个工具，智能体可以直接用于：审计页面、驱动多步流程、监控回归、运行混沌测试、执行全自动发现，以及管理 workspace 与账单，无需跳转到控制台。具体工具组包括：审计与报告；workspace、用量与转化；账单（返回供人类打开的 URL，绝不直接收卡）；流程（描述一段旅程 → 可审阅的规格 → 运行）；监控（按计划监视某个 URL 或流程）；Gremlin（混沌 QA）；发现（全自动：抓取、推断流程、起草流程）；以及 prufa_health_check()（探测服务器/API）。免费与匿名工具无需银行卡；Pro 工具在未订阅时返回 API 的 402 及结账链接（工具可见，付费墙在服务端）。
【使用方式】
- 安装：包已发布在 PyPI，推荐用 pipx 全局安装（隔离 venv，并在 PATH 中暴露 prufa-mcp 二进制文件），或使用 pip 安装到项目 venv。
- 密钥：需要免费的 Prufa API 密钥，首次审计免费、无需银行卡。在 prufa.dev 通过 Google OAuth 登录，然后在控制台创建 API 密钥。
- 接入智能体：MCP 服务器以 stdio 子进程运行，由智能体在首次使用时启动。推荐用 Claude Code 内置的 claude mcp add 命令注册（它会正确写入 ~/.claude.json，而 ~/.claude/mcp.json 路径不行）。重启 Claude Code 后验证，应看到 prufa 显示为 Connected，并列出 prufa_run_audit 与 prufa_get_report 工具。对于 Cursor / Cline / Continue，可手工编辑 .mcp.json（项目根目录或 ~/.config/Claude/ 等位置），重启宿主应用；命令路径必须是绝对二进制路径（~ 与 $() 在 MCP 配置中不会展开）。如果更愿意使用配置文件而非环境变量，可把 token 放到 ~/.config/prufa/mcp.json，详见 ADVANCED.md。
- 调用：prufa_run_audit 默认 wait=true，会阻塞直到审计完成并直接返回 JSON 报告，公开页面通常需要 25–60 秒；若设置 wait=false，则立即返回排队状态和一个 share_token，可用 prufa_get_report 轮询。
【免费试用与升级】 prufa_setup_workspace 会创建一个免费的 agent_temp workspace：无需银行卡，7 天试用，并附带一定的额度预算。监控、发现以及完整长度的 gremlin 运行在试用期内可用，之后需要付费计划。MCP 让智能体可以读懂这些状态：prufa_get_usage、prufa_setup_workspace 以及每个计量结果都带有 trial 信息块（剩余天数与额度）；当额度不足或试用临近结束时，会带有一个 upsell 信息块，其中包含可由智能体转达给人类的 message_for_human，以及应调用的确切工具（prufa_upgrade_plan / prufa_buy_credits）。当在计划外调用 Pro 工具时，会透传 402 及 checkout_url，不会静默失败，也不会产生意外扣费。
【适用场景】 适合 AI 辅助开发（vibe-coding）的应用在发布前后做自动化 QA；在 CI 中作为 PR 检查，当 Prufa 发现严重回归时让 PR 失败（参见 examples/prufa-scan.yml 的完整模板）；也可用于结账等支付流程验证、客户端路由审计等。仓库 examples/ 下有三个可运行脚本：examples/nextjs-app/（审计已部署的 Next.js 应用）、examples/vite-spa/（审计 Vite SPA，侧重客户端路由审计）、examples/stripe-checkout/（审计 Stripe 结账页面，支付流程验证），每个都是可直接复制粘贴的示例。
【限制】 仓库文本说明：命令路径必须为绝对路径；使用 claude mcp add 而非 ~/.claude/mcp.json 路径；试用结束后监控、发现与完整 gremlin 运行需要付费计划；Pro 工具在无计划时不可用。关于具体价格、额度数值、支持的浏览器类型等信息，资料未提供。许可为 Apache-2.0，详见 LICENSE；欢迎贡献，详见 CONTRIBUTING.md。
