Сервер Testmo MCP

Python-сервер Model Context Protocol (MCP) для Testmo — добавьте ИИ-помощника в управление тестированием в Claude Desktop, Cursor и любом другом MCP-совместимом клиенте.

Testmo MCP — это MCP-сервер с открытым исходным кодом, который подключает ИИ-ассистентов, таких как Claude Desktop, Claude Code и Cursor, напрямую к вашему экземпляру Testmo. Управляйте тест-кейсами, папками, этапами, прогонами, вложениями и источниками CI/CD автоматизации — всё это на естественном языке, не покидая своего ИИ-клиента.

Создан для QA-инженеров, SDET и разработчиков, которые используют Testmo и хотят избавиться от рутинных кликов в интерфейсе. Работает на базе FastMCP и REST API Testmo.

✨ Возможности

• 🧪 Полное управление тест-кейсами — создание, чтение, обновление, удаление, поиск и массовые операции с кейсами Testmo

• 📁 Операции с папками — создание, переименование, перемещение, удаление и рекурсивный обход деревьев папок

• 🚀 Массовые и пакетные операции — создание или обновление до 100 кейсов за один вызов, или неограниченное количество с автоматической пакетной обработкой

• 🏃 Тестовые прогоны и результаты — список прогонов, получение деталей прогона и фильтрация результатов

• 🎯 Этапы (Milestones) — список и просмотр этапов в проектах

• 📎 Вложения — загрузка, просмотр и удаление файлов-вложений к тест-кейсам

• 🤖 Источники CI/CD автоматизации — управление прогонами автоматизации, параллельными потоками и отправкой результатов

• 🔗 Интеграции с баг-трекерами — список подключений к GitHub, Jira и другим системам

• 🌳 Рекурсивные помощники — получение целых поддеревьев папок с кейсами за один вызов

• 🛠️ Утилиты сопоставления полей — определение ID приоритетов, типов и состояний без угадывания

• 🤝 Работает с любым MCP-клиентом — Claude Desktop, Claude Code, Cursor, Cline и другими

🚀 Быстрый старт

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

• Python 3.11 или новее

• Менеджер пакетов uv

• Экземпляр Testmo и API-ключ (Settings → API Keys в Testmo)

• MCP-совместимый клиент (Claude Desktop, Cursor и т.д.)

Установка

git clone https://github.com/strelec00/testmo-mcp.git
cd testmo-mcp
uv sync

Конфигурация

Создайте файл .env в корне проекта:

TESTMO_URL=https://your-instance.testmo.net
TESTMO_API_KEY=your-api-key

Подключение к Claude Desktop

Добавьте это в файл конфигурации Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "testmo": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/testmo-mcp", "run", "testmo-mcp.py"],
      "env": {
        "TESTMO_URL": "https://your-instance.testmo.net",
        "TESTMO_API_KEY": "your-api-key"
      }
    }
  }
}

Перезапустите Claude Desktop. Инструменты Testmo появятся в списке инструментов MCP.

💡 Вы можете передать учетные данные через .env или блок env выше — оба варианта работают.

Подключение к Cursor

Откройте Cursor Settings → MCP (или отредактируйте ~/.cursor/mcp.json) и используйте тот же фрагмент JSON.

Режим разработки / тестирования

uv run mcp dev testmo-mcp.py

💬 Примеры запросов

После подключения попробуйте спросить своего ИИ-ассистента:

• "Выведи список всех проектов в Testmo и покажи мне проект с названием Certilligent."

• "Создай 20 тест-кейсов для входа в систему, охватывающих валидные учетные данные, неверный пароль, заблокированную учетную запись, истекшую сессию и потоки 2FA."

• "Найди папку 'Smoke Tests' и рекурсивно выведи список всех кейсов с высоким приоритетом внутри неё."

• "Массово обнови все черновики кейсов в папке 42, установив им высокий приоритет."

• "Покажи мне последний прогон автоматизации для источника Playwright и добавь новый поток результатов."

• "Загрузи этот скриншот как вложение к тест-кейсу 1234."

🧠 Зачем использовать Testmo с MCP?

Традиционные рабочие процессы в Testmo требуют навигации по интерфейсу для каждого тест-кейса, каждой папки, каждого массового обновления. С Testmo MCP ваш ИИ-ассистент становится вторым пилотом в QA:

• Создавайте целые наборы тестов из спецификации функции или PRD за секунды

• Рефакторите структуру папок в диалоговом режиме, а не клик за кликом

• Синхронизируйте Testmo с вашей кодовой базой без переключения контекста

• Используйте в паре с Claude Code для сквозной автоматизации QA: генерируйте тесты Playwright и регистрируйте их в Testmo

• Запускайте прогоны CI/CD автоматизации прямо из сессии терминала

🔧 Доступные инструменты

Проекты

Папки

Тест-кейсы

Этапы (Milestones)

Тестовые прогоны

Вложения

Автоматизация (CI/CD)

Подключения к баг-трекерам

Рекурсивные / составные

Утилиты

🛠️ Устранение неполадок

"Tool not found" в Claude Desktop Используйте абсолютный путь в args и полностью перезапустите Claude Desktop после редактирования конфигурации.

401 Unauthorized Дважды проверьте TESTMO_API_KEY и убедитесь, что для ключа включен доступ к API в Testmo в разделе Settings → API Keys.

uv: command not found Установите uv: curl -LsSf https://astral.sh/uv/install.sh | sh

🤝 Участие в разработке

PR приветствуются. Для крупных изменений сначала откройте issue.

📄 Лицензия

MIT

🔗 Связанные проекты

• Testmo — унифицированное управление тестированием для команд разработки

• Model Context Protocol — открытый стандарт для интеграции ИИ-инструментов

• FastMCP — Python-фреймворк для создания MCP-серверов

• Claude Desktop — десктопный клиент Anthropic с поддержкой MCP

Ключевые слова: testmo mcp, testmo claude, интеграция testmo ai, mcp сервер testmo, model context protocol testmo, testmo python, клиент testmo api, fastmcp testmo, управление тестированием ai, qa автоматизация claude, testmo cursor, api автоматизации testmo, массовое создание кейсов testmo, серверы anthropic mcp