shaft-mcp
Capture browser flows into reviewable Java tests and diagnose failures from evidence
- 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.20261112Add to claude_desktop_config.json
{
"mcpServers": {
"shaft-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"shaft-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/shafthq/shaft-engine-mcp:10.4.20261112"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools