用途:在 Playwright 测试与 TestRail 测试管理之间进行双向同步,适合需要将自动化测试与 TestRail 用例、运行和结果联动的测试团队。
主要能力:
- 导入用例生成测试:/pw:testrail import --project <id> --suite <id>,通过 testrail_get_cases 获取用例,按标题、前置条件、步骤和预期结果映射为 Playwright 测试,并以注解形式写入用例 ID。
- 推送结果:/pw:testrail push --run <id>,先用 npx playwright test --reporter=json > test-results.json 生成结果,再按注解中的用例 ID 调用 testrail_add_result,通过为 status_id 1、失败为 5(含错误信息)、跳过为 2。
- 创建测试运行:/pw:testrail run --project <id> --name "Sprint 42 Regression",调用 testrail_add_run 并包含注解中的用例 ID,返回运行 ID。
- 同步状态:/pw:testrail status --project <id>,对比 TestRail 用例与本地注解,报告覆盖率与未关联数量。
- 更新用例:/pw:testrail update --case <id>,从测试代码提取步骤与预期结果并调用 testrail_update_case。
使用方式:需设置环境变量 TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY,未设置时应提示配置并停止。MCP 服务器不会自动注册,需手动启用:cd integrations/testrail-mcp && npm install,再在用户或项目 MCP 配置中注册服务器;仅设置环境变量不够,否则 testrail_* 工具与 /pw:testrail 命令会报“tool not found”。
注解格式:测试中通过 test.info().annotations.push({ type: 'testrail', description: 'C12345' }) 建立 Playwright 与 TestRail 的关联。
限制:依赖 MCP 工具与手动注册;资料未提供价格、平台支持范围及具体错误处理细节。