playwright-trace-decoder-mcp

playwright-trace-decoder-mcp

vola-treblaMIT
1 звёзд
Playwright Trace Decoder — MCP-сервер для распаковки и анализа trace.zip, которые создаёт Playwright при прогоне тестов. Когда тест падает в CI, трейс сохраняет все действия, скриншоты и логи. Но LLM не могут прочитать бинарный zip, а полный дамп JSON превышает контекстное окно. Сервер решает эту проблему: он преобразует архив в набор инструментов, понятных AI-агенту, и выдаёт ровно ту информацию, которая нужна для поиска корня ошибки. Вам больше не нужно вручную копировать логи в ChatGPT. Сервер сам находит место сбоя: файл, строку, колонку. Он извлекает критические скриншоты до и после ошибки. Позволяет обрезать трейс для экономии места в CI. Использует пагинацию и ARIA-сжатие, чтобы снизить расход токенов. Это ускоряет диагностику и сокращает время простоя CI.
MonitoringBrowserPlaywright
Открыть на GitHub

Установка

npx -y playwright-trace-decoder-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикvola-trebla
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Распаковывает Playwright trace.zip и предоставляет доступ ко всем шагам теста с временными метками и статусами
  • Извлекает точное место ошибки: файл, строку, колонку через инструмент map_locator_to_source
  • Достаёт критические визуальные кадры (скриншоты) до и после сбоя через extract_critical_frames — позволяет визуально проверить состояние страницы
  • Обрезает архив трейса до ключевых шагов с помощью trim_trace_archive, уменьшая размер для хранения в CI
  • Показывает полный стек вызовов и сообщение об ошибке для каждого упавшего действия
  • Разбивает данные на страницы — не перегружает контекст AI даже при больших трейсах
  • Сжимает ARIA-разметку, дополнительно экономя токены
  • Предоставляет единый интерфейс для 16 специализированных инструментов — не нужно писать собственные парсеры

Как подключить

  1. Установите сервер через npx:
    npx -y playwright-trace-decoder-mcp
  2. Добавьте конфигурацию в ваш MCP-клиент (например, Claude Desktop):
    { "mcpServers": { "playwright-trace-decoder": { "command": "npx", "args": ["-y", "playwright-trace-decoder-mcp"] } } }
  3. Перезапустите клиент, чтобы новые инструменты стали доступны.

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

  • «Найди ошибку в трейсе /path/to/trace.zip и покажи, в каком файле и строке произошёл сбой»
  • «Извлеки скриншот страницы прямо перед падением теста из трейса /path/to/trace.zip»
  • «Обрежь трейс /path/to/trace.zip, оставив только шаги вокруг ошибки, чтобы уменьшить размер»
  • «Покажи все шаги теста из трейса /path/to/trace.zip с их статусами и временем выполнения»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, Visual Studio Code, JetBrains IDE, любой MCP-клиент
  • Установка: npx, npm, yarn

Поделиться