Skip to content
MCP server

shaft-mcp

Capture browser flows into reviewable Java tests and diagnose failures from evidence

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
10.4.20261112
Listing updated
3 days ago

About shaft-mcp

shaft-mcp is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

SHAFT is an MIT-licensed Java test automation engine for web, mobile, API, CLI, database and desktop, and this server exposes its capture and diagnosis workflow to an agent. It is distributed as an OCI container image and runs over stdio.

The capture lifecycle records an approved browser flow, then generates native Java that you review, keeping replay evidence with the recording. On the diagnosis side, tools classify a failed Allure report or a trace to a cause such as a locator problem and offer remediation guidance. The docs stress that model choice stays with your client, tests remain ordinary Java, and proposals do not silently edit, approve or merge anything.

The engine underneath manages Selenium and Appium drivers, waits and evidence, and every run produces an Allure report; it scales through Grid, BrowserStack or LambdaTest and works with TestNG, JUnit or Cucumber. A CLI, IntelliJ plugin and agent skill pack come from the same project.

Install

Run in a terminal

claude mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shaft-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shaft-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shaft-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shaft-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shaft-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
      ]
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

capture_start
Begins capturing an approved browser flow.
capture_stop
Stops the capture.
capture_generate_replay
Generates replay evidence and Java for the captured flow.
doctor_analyze_failed_allure
Classifies failed Allure evidence and suggests review-only remediation.
doctor_analyze_trace
Classifies a trace to find the cause of a failure.

What it does

Flow capture
Start, stop and generate replay from an approved browser session.
Generated Java
Captured flows become native Java for review.
Failure diagnosis
Classify failed Allure or trace evidence offline.
Review-only fixes
Remediation guidance is a proposal and never merges itself.
Six test surfaces
Engine covers web, mobile, API, CLI, database and desktop.
Allure on every run
Steps, screenshots and logs land in a report.

Good for

  • Turn a manual browser walkthrough into a Java test
  • Find out whether a red build is a locator issue
  • Add evidence-backed triage to a CI failure
  • Move an existing Selenium suite onto SHAFT

Pricing

Open source

MIT licensed

Prices change. Check shafthq.github.io before you buy.

shaft-mcp FAQ

What language are the tests?

Ordinary Java, using the SHAFT engine.

Is it open source?

The engine is MIT licensed and on Maven Central, per its README.

Will it change my code on its own?

No. The docs say proposals do not silently edit, approve or merge.

How is it packaged?

As an OCI image, ghcr.io/shafthq/shaft-engine-mcp, over stdio.

Is shaft-mcp free?

Yes. shaft-mcp is open source, so you can use and self-host it for free.

How do I add shaft-mcp to Claude Code?

Run this command in your terminal: claude mcp add shaft-mcp -- docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112

What are the best alternatives to shaft-mcp?

The closest alternatives to shaft-mcp are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to shaft-mcp

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools