ats-mcp

LLM이 ActionTestScript 테스트 세션(웹, 모바일, 데스크톱, API)을 ats-core의 REPL을 통해 제어할 수 있게 해주는 MCP 서버입니다.

Claude Code, Claude Desktop, Cursor 또는 MCP를 지원하는 모든 클라이언트와 함께 사용하여 어시스턴트가 테스트 대상 시스템과 실제로 상호작용하도록 할 수 있습니다. 채널 시작, 요소 클릭, 스크린샷 캡처, DOM 또는 모바일 뷰 계층 구조 검사, ATS 스크립트 실행 등을 모두 도구 호출로 수행합니다.

두 가지 배포판이 제공되며, 둘 다 동일한 도구 세트에 연결되어 있습니다:

작동 방식

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만으로 웹/데스크톱/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개의 도구:

세션 / 채널

탐색 (웹)

상호작용

검사

창 / 탭

탈출구

Playwright MCP와의 비교

ats-mcp는 웹에 대해 @playwright/mcp와 동일한 상호작용 범위를 다루며, Playwright가 지원하지 않는 세 가지 기능을 추가로 제공합니다:

• 멀티 플랫폼 — 웹, 모바일(Android/iOS 실기기, 시뮬레이터, 에뮬레이터, Genymotion Cloud), 데스크톱 앱(ATS 시스템 드라이버 사용), REST/SOAP API, SAP GUI.

• 암시적 대기(Implicit wait) 내장 — 요소 검색 시 백오프를 포함하여 재시도하므로, 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와 동일합니다.