shaft-mcp server

SHAFT

Reliable Java test automation, from first intent to production-grade evidence.

One strong, maintainable framework for Web, Mobile, API, CLI, Database, and native testing—with synchronized actions, configuration-first execution, readable assertions, and unified reports.

Generate your first project · Explore the user guide · Star SHAFT on GitHub ⭐

SHAFT removes the repeated plumbing around drivers, waits, assertions, configuration, test data, screenshots, logs, and Allure evidence. Its modular Maven reactor keeps the core lean and lets teams add advanced tooling only when they need it.

Local agency (ChaosEngine)

• FreeToken / llama.cpp on ROG: resolve with chaos-engine/skills/local-agency (dispatch.py --prefer freetoken or OpenAI-compat on :8080).
• Colibri is optional only when http://127.0.0.1:8000 is READY; not the default on 6GB VRAM laptops.
• Three-stage UX (Architect, Automation, Reporting): see chaos-engine/README.md.
• Proof runner note (#6045): preferred dense coder is Qwen2.5-Coder-7B Q4KM via llama-server when FreeToken KV is ~8k.

From zero to useful evidence

ready-to-run Maven project.

1. Open the SHAFT landing page and generate a

1. Extract it and run:

mvn test

1. Inspect the sample result, screenshots, logs, and Allure evidence.

The generated project uses the canonical Maven coordinate io.github.shafthq:shaft-engine and gives you a repeatable baseline for local runs and CI.

One orchestration layer, every execution surface

Test intent and configuration enter SHAFT's orchestration layer, fan out across the required execution surfaces, and return through one unified evidence flow.

flowchart LR
    accTitle: SHAFT execution and evidence workflow
    accDescr: Test intent and configuration enter SHAFT orchestration, run across Web, Mobile, API, and Native execution surfaces, and produce unified evidence.
    I[Test intent] --> S[SHAFT orchestration]
    C[Configuration] --> S
    S --> W[Web]
    S --> M[Mobile]
    S --> A[API]
    S --> N[Native, CLI, and Database]
    W --> E[Unified evidence]
    M --> E
    A --> E
    N --> E

Shortened. The full README is on GitHub.