内容
# 一键检查:Claude 自动 QA、调试器和 UI/UX 验证器(MCP Server)
[](https://www.npmjs.com/package/claude-just-check-it)
[](https://opensource.org/licenses/MIT)
专为 **Claude Desktop** 打造的精英级自动质量保证、调试和 UI/UX 验证工程师,基于模型上下文协议(MCP)构建。
该工具不仅仅是截图。它会读取您的代码库,自动提取登录信息,动态控制无头浏览器,将您的实时 UI 与 Figma 设计文件进行比较,注入调试日志以跟踪复杂的 state 错误,并在完成后完美清理。
## ✨ 功能
- 🕵️ **深度自动发现**:自动搜索您的 `.env`、种子文件和代码库,以提取测试用的电子邮件、密码、路由和 `data-testid` 选择器。
- 🛣️ **动态 Playwright 旅程**:Claude 实时编写 Playwright 脚本,可以导航、填写表单、点击按钮,并处理复杂的登录流程。
- 🎨 **UI/UX 像素验证模式**:传递给 Claude 一个设计模型图像。它将渲染您的本地实时网站,将两个图像拉入其上下文窗口,并提供您遗漏的像素级 CSS 审计。
- 💉 **深度调试注入**:如果 React/Next.js 状态中隐藏了错误,Claude 将动态注入 `console.log()` 到您的文件中,运行浏览器,读取日志并查找错误。
- 🧹 **绝对清理**:每个注入的日志都将被恢复。每个 Node/Vite 进程都将被无情地杀死(`process.kill(-pid)`)。零僵尸进程。
## 📦 Claude Desktop 安装
1. 打开您的 Claude Desktop 配置文件:
- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
2. 添加以下 MCP 服务器配置:
```json
{
"mcpServers": {
"just-check-it": {
"command": "npx",
"args": ["claude-just-check-it"]
}
}
}
```
1. **重启 Claude Desktop.**
## 🛠️ 提供工具
1. `discover_project_context`:提取路由、凭证和选择器。
2. `start_project`:安全启动开发服务器。
3. `execute_playwright_journey`:执行顺序浏览器数组(前往、填写、点击)。
4. `verify_ui_against_design`:捕获实时 UI 并与用户模型进行比较。
5. `inject_debug_logs`:暂时修改文件以进行深度状态跟踪。
6. `cleanup_session`:恢复文件并终止进程。
## 🤝 贡献
开放 PR。此项目旨在成为 AI 驱动软件开发的终极伴侣。
## 🤝 贡献
开放 PR。此项目旨在成为 AI 驱动软件开发的终极伴侣。