ats-mcp

LLM が ActionTestScript のテストセッション（Web、モバイル、デスクトップ、API）を ats-core の REPL を通じて実行できるようにする MCP サーバーです。

Claude Code、Claude Desktop、Cursor、または MCP 対応クライアントで使用することで、アシスタントがテスト対象のシステムを実際に操作できるようになります。チャネルの起動、要素のクリック、スクリーンショットのキャプチャ、DOM やモバイルビュー階層の検査、ATS スクリプトの実行などをすべてツール呼び出しとして行えます。

2 つの配布形式が用意されており、どちらも同じツールセットに接続されています。

仕組み

MCP client (Claude Code / Desktop / …)
         │
         ▼
   ats-mcp launcher  (Node OR Java — see /node and /java in this repo)
         │
   spawns / loads
         │
         ▼
  AtsReplServer (ats-core)
         │
  ┌──────┼──────┬───────┐
  ▼      ▼      ▼       ▼
 web   mobile  desktop api

初回使用時、ランチャーは ATS が必要とするすべてのものを ~/.actiontestscript/ 配下にプロビジョニングします：

• libs — ~/.actiontestscript/libs/ が存在しない場合、https://actiontestscript.org/releases/ats-libs/<version>.zip からダウンロードされます。

• system driver (デスクトップアプリ自動化用) — https://actiontestscript.org/releases/ats-drivers/<os>/system/ から最新バージョンが取得され、新しいバージョンが公開されると自動的にアップグレードされます。

• browser drivers — ブラウザ/バージョンごとの最初の start_channel 時に、ats-core 自体がオンデマンドで取得します。

手動インストール手順は不要です。npx -y ats-mcp または java -jar ats-mcp.jar を実行するだけで、ゼロから Web/デスクトップ/API 自動化を開始できます。

Related MCP server: InSite

前提条件

• Java 17+ (必須 — ats-core は JVM 上で動作します)。Adoptium Temurin またはパッケージマネージャーからインストールしてください。

• Node 18+ (npm 配布形式を使用する場合のみ)。nodejs.org またはパッケージマネージャーからインストールしてください。

Maven は不要です。両方の配布形式にビルド済みファイルが含まれています。Maven はソースから JAR をビルドする場合にのみ必要です (java/ を参照)。

MCP クライアントの設定

Claude Code

プロジェクトのルートに .mcp.json を追加します：

{
  "mcpServers": {
    "ats": {
      "command": "npx",
      "args": ["-y", "ats-mcp@latest"]
    }
  }
}

または、JAR を使用する場合：

{
  "mcpServers": {
    "ats": {
      "command": "java",
      "args": ["-jar", "/path/to/ats-mcp-0.4.0.jar"]
    }
  }
}

Claude Desktop

claude_desktop_config.json に同様の形式で記述します。

環境変数

公開されるツール

用途別にグループ化された 30 個のツール：

セッション / チャネル

ナビゲーション (Web)

インタラクション

検査

ウィンドウ / タブ

エスケープハッチ

Playwright MCP との比較

ats-mcp は Web に関しては @playwright/mcp と同じインタラクション範囲をカバーし、さらに Playwright が行わない以下の 3 点を提供します：

• マルチプラットフォーム — Web、モバイル (Android/iOS 実機、シミュレーター、エミュレーター、Genymotion Cloud)、デスクトップアプリ (ATS システムドライバー経由)、REST/SOAP API、および SAP GUI。

• 暗黙的な待機機能 — 要素の検索はバックオフを伴って再試行されるため、LLM がすべてのアクションの周囲に wait_for 呼び出しを記述する必要はありません。

• 生のエスケープハッチ — 専用ツールでは不十分な場合に、run_ats_block を使用して ATS アクションの全語彙を利用できます。

リポジトリ構成

ats-mcp/
├── node/      — TypeScript implementation (published to npm)
├── java/      — Maven implementation (released as a fat JAR)
├── README.md
└── .gitlab-ci.yml

両方の実装は同じプロトコルサーフェスをターゲットとしており、同じツール定義を共有しています。

ライセンス

Apache-2.0 — ats-core と同じです。