TestDriver
MCP-сервер, агент и скиллы для сквозных UI-тестов: агент управляет компьютером через компьютерное зрение на облачных машинах
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Выполняет реальные действия в интерфейсе и может запускать команды
- Отправляет приложение и данные в облако вендора
- Требует секретный ключ доступа
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/testdriverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'TD_API_KEY=<ваш TD_API_KEY>' testdriver -- npx -p testdriverai testdriverai-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"testdriver","type":"stdio","command":"npx","args":["-p","testdriverai","testdriverai-mcp"],"env":{"TD_API_KEY":"<ваш TD_API_KEY>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"testdriver": {
"type": "stdio",
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add testdriver --env 'TD_API_KEY=<ваш TD_API_KEY>' -- npx -p testdriverai testdriverai-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.testdriver]
command = "npx"
args = ["-p", "testdriverai", "testdriverai-mcp"]
env = { TD_API_KEY = "<ваш TD_API_KEY>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"testdriver": {
"type": "local",
"command": [
"npx",
"-p",
"testdriverai",
"testdriverai-mcp"
],
"environment": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"testdriver": {
"command": "npx",
"args": [
"-p",
"testdriverai",
"testdriverai-mcp"
],
"env": {
"TD_API_KEY": "<ваш TD_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
TD_API_KEYсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Подключи MCP testdriver командой npx -p testdriverai testdriverai-mcp с переменной TD_API_KEY, или в Claude Code выполни /plugin marketplace add testdriverai/testdriverai и /plugin install testdriver@testdriver. Для нового проекта запусти npx testdriverai init.
Другие способы из описания автора
npx testdriverai initСоздает проект, ставит Vitest и настраивает MCP для редактора. Дальше vitest run прогоняет тест.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий отдает MCP-сервер, агента-эксперта и набор скиллов для Claude Code и Codex, чтобы писать и запускать сквозные тесты через управление интерфейсом. Тесты формулируются обычными словами: найти элемент, кликнуть, проверить, что что-то видно, а движок опирается на зрение, а не на селекторы. Прогон идет на эфемерной облачной машине, которая запускает браузер или приложение и возвращает результат с видеозаписью. Есть CLI для инициализации проекта и подключения к Vitest, а также самостоятельный npm-пакет.
Для кого. Для QA-инженеров и разработчиков, которым нужны сквозные тесты сложных сценариев: десктоп, расширения, OAuth, PDF, iframe и canvas.
Подходит, если
- Нужно проверить сценарий, который трудно покрыть селекторными тестами
- Хочется описывать шаги теста словами и запускать их из агента
- Нужен прогон в облаке с видеозаписью и отчетом
Не подходит, если
- Достаточно обычных модульных или селекторных тестов без облака
- Нельзя выводить приложение и данные во внешний сервис
Пример запроса к агенту
Напиши тест: открой сайт, войди через OAuth и проверь, что видно имя пользователяОграничения
Нужен аккаунт TestDriver и ключ TD_API_KEY, прогоны идут на облачных машинах вендора, тарификация по их условиям. Доступность сервиса из России без VPN не проверена. Тесты выполняют реальные действия в интерфейсе и могут запускать команды, поэтому подходят для тестовых окружений, а не для продакшена.
Как отключить. Удалите плагин testdriver через /plugin, уберите блок MCP testdriver из конфигурации агента и удалите пакет testdriverai из проекта.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TD_API_KEY обязательная, секрет | Ключ доступа к облаку TestDriver из консоли аккаунта. |
Проверка безопасности
- Выполняет реальные действия в интерфейсе и может запускать команды
- Отправляет приложение и данные в облако вендора
- Требует секретный ключ доступа
Коротко о README
README представляет TestDriver как инструмент сквозного тестирования, где агент управляет интерфейсом через зрение. Быстрый старт: npx testdriverai init создает проект, ставит Vitest и настраивает MCP для VS Code, Cursor или Claude Desktop, затем vitest run прогоняет тест на облачной машине с видеозаписью. Репозиторий содержит MCP-сервер, агента, десятки скиллов по отдельным действиям, CLI и расширение для редактора. Заявлена поддержка десктопных приложений, расширений браузера, OAuth, PDF, iframe и canvas.
Частые вопросы
Нужен ли платный аккаунт?
Нужен аккаунт TestDriver и ключ TD_API_KEY, прогоны идут в их облаке. Регистрация бесплатная, дальнейшие лимиты и тарифы на стороне вендора.
Чем это отличается от Playwright или Cypress?
Тест описывается словами и опирается на компьютерное зрение, а не на селекторы, поэтому покрывает десктоп, расширения, OAuth, PDF, iframe и canvas.
Похожие
CLI для тестирования и ред-тиминга LLM-приложений: сравнение моделей, автоматические проверки в CI и поиск уязвимостей
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете
Официальный MCP-сервер SonarSource: проблемы качества и безопасности, quality gates и анализ кода из SonarQube Server и Cloud