Greenrun

greenrun-cli

Claude Code 的浏览器测试管理工具。用纯英文编写测试，Claude 会自动生成并运行 Playwright 脚本。

Greenrun 是一款 MCP 服务，可将 Claude Code 连接到 Greenrun API。描述要测试的内容，剩下的交给 Greenrun——包括脚本生成、并行执行、结果跟踪，以及仅重新运行所需的测试。

快速开始

npx greenrun-cli init

设置向导将会：

1. 验证你的 Greenrun API 令牌
2. 为 Claude Code 配置 Greenrun 和 Playwright MCP 服务
3. 安装 /greenrun 和 /greenrun-sweep 斜杠命令
4. 将项目说明添加到你的 CLAUDE.md
5. 设置工具权限，让测试无需提示即可运行

前往 app.greenrun.dev/tokens 获取 API 令牌。

前置条件

• Node.js 18+
• Claude Code — 安装指南
• Playwright MCP — 由 init 自动配置

工作原理

1. 在控制面板中定义测试，或通过 Claude Code 使用 MCP 工具定义测试
2. 运行 /greenrun — Claude 获取测试，首次运行时生成 Playwright 脚本，随后直接执行
3. 脚本会缓存 — 后续运行会跳过生成步骤，通过 npx playwright test 立即执行
4. 结果会被跟踪 — 每次运行都会存储通过/失败状态、耗时和摘要

脚本生成

首次运行时，Claude 会在浏览器中逐步执行每项测试的说明（侦察阶段），观察 UI 状态，并使用真实选择器生成 .spec.ts 脚本。脚本会保存到 API，以供后续运行复用。

如果缓存的脚本运行失败，AI Agent 会手动重新执行测试，以判断脚本是否已过时，或是否存在实际错误。过时的脚本会自动清除，以便重新生成。

身份验证

项目支持命名的凭据集（名称、电子邮件、密码）。每项测试都可以通过 credential_name 按名称引用凭据。执行期间，系统会使用匹配的凭据进行身份验证，然后运行测试。

影响分析

代码更改后，运行 /greenrun-sweep，查找受已更改页面影响的测试。系统只会重新运行相关测试。

斜杠命令

/greenrun [filter]

运行当前项目的测试。支持以下筛选条件：

• /greenrun — 运行所有启用的测试
• /greenrun tag:smoke — 运行带有“smoke”标签的测试
• /greenrun /checkout — 运行关联到匹配“/checkout”的页面的测试
• /greenrun login — 运行名称中包含“login”的测试

/greenrun-sweep

检测近期 git 更改影响了哪些测试，并提供运行这些测试的选项。

MCP 工具

工具	描述
list_projects	列出所有项目
create_project	创建项目（包含凭据和身份验证配置）
get_project	获取项目详情
update_project	更新项目设置
list_pages	列出项目中的页面
create_page	注册页面 URL
list_tests	列出测试及最近一次运行状态
get_test	获取完整的测试详情和说明
create_test	创建测试（包含 credential_name、标签和页面）
update_test	更新测试（内容更改时自动使脚本失效）
prepare_test_batch	获取、筛选一批测试并启动运行
export_test_script	将测试缓存的 Playwright 脚本写入本地文件（避免脚本占用上下文）
export_test_instructions	将测试说明写入本地文件（避免说明占用上下文）
sweep	查找受指定页面影响的测试
start_run	启动测试运行
complete_run	记录单项测试结果
batch_complete_runs	一次调用即可记录多次测试运行的结果
get_run	获取运行详情
list_runs	列出运行历史

手动设置

如果你更希望手动配置，而不是使用 init：

claude mcp add greenrun --transport stdio -e GREENRUN_API_TOKEN=your_token -- npx -y greenrun-cli@latest
claude mcp add playwright -- npx @playwright/mcp@latest --browser chrome --user-data-dir ~/.greenrun/browser-profile

或者添加到项目的 .mcp.json 中：

{
  "mcpServers": {
    "greenrun": {
      "command": "npx",
      "args": ["-y", "greenrun-cli@latest"],
      "env": { "GREENRUN_API_TOKEN": "${GREENRUN_API_TOKEN}" }
    }
  }
}

CLI 命令

greenrun init             Interactive setup wizard
greenrun update           Update templates and commands to latest version
greenrun serve            Start MCP server directly
greenrun --version        Print version
greenrun --help           Print help

非交互式初始化：

npx greenrun-cli init --token gr_xxx --scope local --no-claude-md --no-commands

许可证

MIT