ats-mcp

Ein MCP-Server, der es einem LLM ermöglicht, ActionTestScript-Testsitzungen — Web, Mobil, Desktop und API — über die REPL von ats-core zu steuern.

Verwenden Sie ihn mit Claude Code, Claude Desktop, Cursor oder einem beliebigen MCP-fähigen Client, damit der Assistent tatsächlich mit einem zu testenden System interagiert: Kanäle starten, Elemente anklicken, Screenshots aufnehmen, das DOM oder die mobile Ansichtshierarchie untersuchen, ATS-Skripte ausführen — alles als Tool-Aufrufe.

Es sind zwei Distributionen verfügbar, die beide mit demselben Satz an Tools verbunden sind:

Funktionsweise

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

Bei der ersten Verwendung stellt der Launcher alles bereit, was ATS unter ~/.actiontestscript/ benötigt:

• libs — heruntergeladen von https://actiontestscript.org/releases/ats-libs/<version>.zip, falls ~/.actiontestscript/libs/ fehlt.

• Systemtreiber (für Desktop-App-Automatisierung) — die neueste Version wird von https://actiontestscript.org/releases/ats-drivers/<os>/system/ abgerufen und automatisch aktualisiert, wenn eine neuere Version veröffentlicht wird.

• Browser-Treiber — werden bei Bedarf von ats-core selbst beim ersten start_channel pro Browser/Version abgerufen.

Kein manueller Installationsschritt erforderlich — npx -y ats-mcp oder java -jar ats-mcp.jar reicht aus, um von Null auf Web-/Desktop-/API-Automatisierung zu gelangen.

Voraussetzungen

• Java 17+ (immer erforderlich — ats-core ist JVM)

• Node 18+ (nur wenn Sie die npm-Distribution verwenden)

Konfigurieren Sie Ihren MCP-Client

Claude Code

Fügen Sie eine .mcp.json im Projektstammverzeichnis hinzu:

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

Oder mit der JAR:

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

Claude Desktop

Dieselbe Struktur, in claude_desktop_config.json.

Umgebungsvariablen

Verfügbare Tools

30 Tools, gruppiert nach Zweck:

Sitzung / Kanäle

Navigation (Web)

Interaktion

Inspektion

Fenster / Tabs

Ausweg

Positionierung gegenüber Playwright MCP

ats-mcp deckt dieselbe Interaktionsoberfläche ab wie @playwright/mcp für das Web, plus drei Dinge, die Playwright nicht kann:

• Multi-Plattform — Web, Mobil (Android/iOS physisch, Simulatoren, Emulatoren, Genymotion Cloud), Desktop-Apps (via ATS-Systemtreiber), REST/SOAP-APIs und SAP GUI.

• Implizites Warten integriert — Element-Suchvorgänge werden mit Backoff wiederholt, sodass das LLM nicht um jede Aktion wait_for-Aufrufe herumschreiben muss.

• Roher Ausweg — run_ats_block macht das vollständige ATS-Aktionsvokabular zugänglich, wenn ein speziell dafür entwickeltes Tool nicht ausreicht.

Repository-Struktur

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

Beide Implementierungen zielen auf dieselbe Protokolloberfläche ab und teilen sich dieselben Tool-Definitionen.

Lizenz

Apache-2.0 — identisch mit ats-core.