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 自動化を開始できます。

前提条件

• Java 17+ (必須 — ats-core は JVM 上で動作します)

• Node 18+ (npm 配布形式を使用する場合のみ)

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 と同じです。