SuperAPI AI 工具集

run-e2e

测试与质量

查看项目

更新于 10-16 07:16

技能介绍

用途:对托管的 MCP Cloudflare Worker 运行基于 Playwright 的端到端测试。测试通过 MCP Inspector 界面执行完整 OAuth 流程,连接真实的 Forms worker(src/worker.ts),其中包含 Forms 工具集合与进程内 CMS 链式调用。

主要文件:测试文件 tests/forms-hosted-e2e/e2e/mcp-inspector.test.ts;worker 配置 tests/forms-hosted-e2e/e2e/helpers/worker-setup.ts;Wrangler 配置 tests/forms-hosted-e2e/wrangler.e2e.toml;共享测试辅助来自 @umbraco-cms/mcp-hosted/testing。

使用步骤:

  1. 检查前置条件:确认 demo-site/ 存在(含 .csproj 文件),否则提示运行 npx create-umbraco-mcp-server init。
  2. 清理占用 E2E 端口的陈旧进程:npm run kill:e2e-ports。
  3. 构建 worker:npm run build。
  4. 以后台子进程启动 Umbraco:npm run start:umbraco,并循环健康检查 https://localhost:44374 最多 120 秒,超时则停止。
  5. 运行测试:npm run test:e2e;指定测试可用 npx playwright test --config tests/forms-hosted-e2e/e2e/playwright.config.ts -g "<test-name>"。可用参数 --headed、--debug、SLOW_MO=500。Worker 与 MCP Inspector 由测试框架自动启动,无需手动设置。
  6. 报告结果,失败时阅读相关测试文件与错误输出以协助诊断。
  7. 清理:测试后不要停止 Umbraco,除非用户明确要求。

一次性前置条件(不属于技能流程):demo-site/ 目录中的 Umbraco 演示站点;后台用户凭据 admin@test.com / SecurePass1234;在 Umbraco 后台注册 OAuth 客户端 umbraco-mcp-forms-hosted;安装 Playwright 浏览器 npx playwright install。

限制:仅依据资料所述流程;具体错误信息、耗时与测试覆盖范围暂未提供。