testpilot (Aishwary Shrivastav)

试飞员mcp

](https://www.npmjs.com/package/testpilot-mcp)  ](https://nodejs.org)

Vibe测试您的应用程序。只需描述要测试的内容。

testpilot mcp是一个与之协同工作的mcp服务器 @剧作家/mcp。您用简单的英语描述要测试的功能——Claude处理其余部分：扫描您的代码库，使用您的真实路由和字段名生成测试计划，驱动浏览器，截图，记录通过/失败结果，并编写HTML报告。

You: "test the login flow"
  ↓
testpilot   → scans code, finds /login route + LoginForm fields
            → generates a 12-step test plan with real field names
            → instructs Claude to drive the browser
playwright  → navigates, fills forms, clicks, takes screenshots
testpilot   → records every assertion + screenshot
            → writes HTML report with visual proof

______________________________________________________________________

快速开始

1.将两个MCP服务器添加到Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    },
    "testpilot": {
      "command": "npx",
      "args": ["testpilot-mcp"]
    }
  }
}

2.启动您的开发服务器 (npm run dev, pnpm dev等等）

3.打开克劳德代码，说：

“使用testpilot扫描此项目，然后测试登录流程”

就是这样，一切都是克劳德策划的。

______________________________________________________________________

克劳德做了什么（自动）

tp_scan_project   → framework: react-router, 7 routes, 4 forms detected
tp_start          → session "Login flow" started
tp_get_context    → reads Login.tsx, useAuth.ts (your actual source)
tp_plan           → generates 12 steps with real field names: email, password

── Claude executes using Playwright MCP ──

browser_navigate        → http://localhost:8080/login
browser_take_screenshot → 📸 (page load proof)
tp_assert               → "Login page loaded" ✅ PASS

browser_fill_form       → { email: "test@example.com", password: "SecureTest123!" }
browser_click           → submit button
browser_take_screenshot → 📸 (after submit proof)
tp_assert               → "Form submitted" ✅ PASS

browser_network_requests → POST /api/auth → 200 OK
tp_assert               → "Auth API returned 200" ✅ PASS

browser_snapshot        → confirms redirect to /clients
tp_assert               → "Redirected to dashboard" ✅ PASS

── Edge cases ──

browser_navigate        → /login (fresh)
browser_click           → submit (empty form)
browser_take_screenshot → 📸 (validation errors proof)
tp_assert               → "Empty form shows validation errors" ✅ PASS

tp_end  → PASSED · testpilot-reports/tp-1234567890.html

______________________________________________________________________

HTML报告

tp_end 将一个自包含的HTML文件写入 ./testpilot-reports/:

• 通过/失败 顶部徽章
• 项目摘要：框架、扫描的路线、表单、API端点
• 带有实际值与预期值的断言表
• 嵌入截图 在每个断言下作为视觉证明
• 带计时的完整步骤日志

______________________________________________________________________

工具参考

testpilot公开了6个工具。Playwright MCP处理所有浏览器交互。

______________________________________________________________________

支持的框架

______________________________________________________________________

手动工作流程（用于更多控制）

tp_scan_project { path: "/absolute/path/to/your/project" }
tp_start { project_path: "/absolute/path/to/your/project", name: "Sprint 4 — Login" }
tp_get_context { feature: "login" }
tp_plan { feature: "login flow", edge_cases: true }

# Claude executes each step, then:
tp_assert { label: "Login page loaded", passed: true, screenshot: "" }
tp_assert { label: "Form submits successfully", passed: true, screenshot: "" }

tp_end

______________________________________________________________________

本地开发

git clone https://github.com/AishwaryShrivastav/testpilot.git
cd testpilot
npm install
npm test   # all 28 integration checks — no browser needed

在本地副本上进行点测试：

"testpilot": {
  "command": "node",
  "args": ["/absolute/path/to/testpilot/src/index.js"]
}

______________________________________________________________________

需求

• Node.js 18+
• @剧作家/mcp --浏览器驱动程序（Chromium捆绑）
• testpilot本身：零重依赖（仅限MCP SDK+Zod，约2 MB）

______________________________________________________________________

贡献

1. Fork → 特性分支
2. 编辑 src/
3. npm test --必须通过所有28项检查
4. 拉取请求

问题和请求：

______________________________________________________________________

许可证

麻省理工学院