shaft-mcp について
SHAFT はテストチーム向けの Java 自動化エンジンで、Web、モバイル、API、CLI、データベース、デスクトップのテストを単一 API で扱います。ドライバーと待機処理を管理し、実行ごとにステップ、スクリーンショット、ログを含む Allure レポートを生成します。
主な機能
- 01複数のテスト対象を単一 API で操作
- 02Selenium と Appium のドライバー管理
- 03同期操作とスマート待機
- 04ステップ、画像、ログを含む Allure レポート
- 05ローカル、Grid、BrowserStack、LambdaTest で実行
活用シーン
- 01Web とモバイルを一つのプロジェクトでテスト
- 02REST または GraphQL API テストを作成
- 03CLI、データベース、デスクトップをテスト
- 04Allure でテスト手順と証跡を確認
MCP 対応
README では AI エージェント向けの MCP ツールに触れていますが、MCP サーバーが提供する機能の詳細は示されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ghcr.io/shafthq/shaft-engine-mcp:10.4.20261024stdioツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
テストを書けば、あとはSHAFTにおまかせ。
Web、モバイル、API、CLI、データベース、デスクトップに対応する1つのJavaエンジンです。
ドライバー、待機処理、証跡は自動で処理されます。実行のたびにAllureレポートが生成されます。
SHAFT_ENGINEにアップグレード · ▶ 音声と字幕付きの26秒の動画を見る · 100秒の概要
SHAFTを選ぶ理由
- 面倒な設定は不要です。 SeleniumとAppiumのドライバー、同期アクション、スマートな待機処理を管理します。
- 1つの流れるような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 エージェント: AGENTS.md。まず
$shaft-developerを確認し、次にMCP ツールまたはCLI コマンドをご覧ください。 - トレーニング: automatest.orgで実践的なコースを受講できます。
問題を報告 · 行動規範 · セキュリティ · スポンサーになる
BrowserStack、LambdaTest、Applitools、JetBrains は、ツールまたはオープンソースプログラムの支援を提供しています。これはプロジェクトへの支援を示すものであり、金銭的なスポンサーシップ、顧客としての関係、または推奨を意味するものではありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。