ats-mcp

Сервер MCP, позволяющий LLM управлять сеансами тестирования ActionTestScript — веб, мобильные, десктопные приложения и API — через REPL ats-core.

Используйте его с 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 — загружаются из https://actiontestscript.org/releases/ats-libs/<version>.zip, если ~/.actiontestscript/libs/ отсутствует.

• system driver (для автоматизации десктопных приложений) — последняя версия загружается из https://actiontestscript.org/releases/ats-drivers/<os>/system/ и автоматически обновляется при выходе новой версии.

• browser drivers — загружаются по требованию самим ats-core при первом вызове start_channel для конкретного браузера/версии.

Никаких ручных шагов по установке — npx -y ats-mcp или java -jar ats-mcp.jar достаточно, чтобы начать автоматизацию веб-, десктопных приложений или API.

Related MCP server: browser-mcp-server

Предварительные требования

• 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 инструментов, сгруппированных по назначению:

Сеанс / каналы

Навигация (веб)

Взаимодействие

Инспекция

Окно / вкладки

Дополнительные возможности

Сравнение с Playwright MCP

ats-mcp охватывает ту же область взаимодействия, что и @playwright/mcp для веба, плюс три возможности, которых нет у Playwright:

• Мультиплатформенность — веб, мобильные устройства (физические 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.