Greenrun

Name: Greenrun
Author: Add-Item-To

@Add-Item-To

代码仓库主页

关于 Greenrun

Browser test management for Claude Code. Write tests in plain English, run them with /greenrun.

#browser-testing #claude-code #playwright #e2e-testing #natural-language #mcp #testing

基本信息

分类

开发工具

许可证

MIT

运行时

node

传输方式

stdio

发布者

Add-Item-To

提交者

Stewis

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "greenrun": {
      "command": "npx",
      "args": [
        "greenrun-cli"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Greenrun?

Greenrun is an MCP server that connects Claude Code to the Greenrun API for browser test management. You describe tests in plain English, and Claude generates and runs Playwright scripts automatically, handling script generation, parallel execution, result tracking, and re-running only what's needed.

How to use Greenrun?

Run npx greenrun-cli init to launch an interactive setup wizard that validates your API token, configures the Greenrun and Playwright MCP servers, installs slash commands, and adds project instructions. Tests are defined in the Greenrun dashboard or via MCP tools, then executed by running /greenrun in Claude Code. Manual setup is also supported via claude mcp add or .mcp.json.

Key features of Greenrun

Write tests in plain English, no Playwright code needed
Claude generates Playwright scripts on first run
Cached scripts skip generation on subsequent runs
Parallel test execution with result tracking
Impact analysis via /greenrun-sweep for changed pages
Named credential sets for authentication per test
Test filtering by tag, URL path, or name

Use cases of Greenrun

Define and run end-to-end browser tests without writing code
Quickly re-run only the tests affected by recent code changes
Manage test suites across multiple projects with credential management
Integrate browser testing directly into Claude Code workflows

FAQ from Greenrun

What are the prerequisites for using Greenrun?

Node.js 18+, Claude Code, and the Playwright MCP server (configured automatically by the init wizard).

How does Greenrun generate test scripts?

On the first run, Claude walks through each test's instructions in the browser, observes UI states, and generates a .spec.ts script with real selectors. The script is cached and reused on future runs.

How does Greenrun handle test failures due to stale scripts?

If a cached script fails, an AI agent re-executes the test manually to determine whether the script is stale or there is a real bug. Stale scripts are automatically cleared for regeneration.

How does Greenrun handle authentication?

Projects support named credential sets (name, email, password). Each test can reference a credential by name via credential_name, and during execution the matching credentials are used to authenticate.

How can I run only tests affected by recent code changes?

Run the /greenrun-sweep slash command. It detects which tests are impacted by the pages you changed (based on git changes) and offers to run only those tests.

开发工具分类下的更多 MCP 服务器

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K