shaft-mcp

为什么选择 SHAFT

• 无需繁琐配置。 托管 Selenium 和 Appium 驱动程序、同步操作以及智能等待。
• 一套流畅的 API。 在同一项测试中支持 Web、移动端、REST/GraphQL、数据库、CLI 和桌面应用。
• 默认生成证据。 每次运行都会将步骤、屏幕截图和日志写入 Allure 报告。
• 通过配置实现扩展。 支持本地环境、Grid、BrowserStack 或 LambdaTest；以及 TestNG、JUnit 或 Cucumber。
• 开源且值得信赖。 采用 MIT 许可证，发布于 Maven Central，并提供 OpenSSF 记分卡和公开覆盖率数据。

工作原理

测试意图和配置进入 SHAFT 的编排层，分发到所需的各个执行环境，再汇总为统一的证据。

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

快速开始

生成你的第一个项目 并运行 mvn test。如果你已在使用 Maven，请添加 io.github.shafthq:shaft-engine（版本号见 Maven Central 徽章）：

<dependency>
    <groupId>io.github.shafthq</groupId>
    <artifactId>shaft-engine</artifactId>
    <version>${shaft.version}</version>
</dependency>

然后编写测试：

SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://shafthq.github.io/")
      .and().element().assertThat(By.cssSelector("h1")).isVisible();
driver.quit();

运行 mvn test。Allure 报告会打开，其中包含每个步骤、屏幕截图和日志。

接下来

• 编写测试： 用户指南 包含设置说明、完整 API 和示例。
• 使用 IntelliJ： shaft-intellij。
• 贡献或维护： CONTRIBUTING.md 是维护者指南的入口。
• AI Agent： AGENTS.md。从 $shaft-developer 开始，然后查看 MCP 工具或 CLI 命令。
• 培训： 在 automatest.org 上参加实践课程。

---

提交问题 · 行为准则 · 安全 · 赞助

_{BrowserStack、LambdaTest、Applitools 和 JetBrains 提供了工具支持或开源项目支持。这是对项目的支持，并不代表获得了财务赞助、客户身份或背书。}