🚀 operative.sh web-eval-agent MCP-сервер

Позвольте кодирующему агенту отладить себя, у вас есть дела поважнее.

🔥 Усильте свою отладку

MCP-сервер operative.sh запускает браузерный агент для автономного выполнения и отладки веб-приложений непосредственно в редакторе кода.

Related MCP server: Mentor MCP Server

⚡ Особенности

• 🌐 Навигация по веб-приложению с помощью BrowserUse (в 2 раза быстрее с работающим бэкэндом)

• 📊 Захват сетевого трафика — запросы интеллектуально фильтруются и возвращаются в контекстное окно

• 🚨 Собирайте ошибки консоли — записывайте логи и ошибки

• 🤖 Автономная отладка — агент курсора вызывает сервер mcp веб-агента контроля качества, чтобы проверить, работает ли написанный им код так, как ожидалось, от начала до конца.

🧰 Справочник по инструментам MCP

Ключевые аргументы

• web_eval_agent

  • url(обязательно) – адрес запущенного приложения (например http://localhost:3000 )

  • task(обязательно) – описание на естественном языке того, что нужно протестировать («пройдите процесс регистрации и отметьте любые проблемы с пользовательским опытом»)

  • headless_browser(необязательно, по умолчанию — установите значение true , чтобы скрыть окно браузера

• setup_browser_state

  • url(необязательно) – страница, которая будет открыта первой (удобно для перехода непосредственно на экран входа в систему)

Вы можете активировать эти инструменты прямо из чата IDE, например:

Evaluate my app at http://localhost:3000 – run web_eval_agent with the task "Try the full signup flow and report UX issues".

🏁 Быстрый старт (macOS/Linux)

1. Предварительные условия (обычно не требуются):

• brew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• npm: ( brew install npm )

• jq: brew install jq

2. Запустите установщик после получения ключа API (бесплатно)

   • Устанавливает драматурга

   • Устанавливает УФ

   • Вставляет JSON в ваш редактор кода (Cursor/Cline/Windsurf)!

curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Откройте вашу любимую IDE и перезапустите ее, чтобы применить изменения.

4. Отправьте запрос в режиме чата для вызова инструмента веб-агента оценки! Например:

Test my app on http://localhost:3000. Use web-eval-agent.

🛠️ Ручная установка

1. Получите свой ключ API на operative.sh

2. Установить УФ

curl -LsSf https://astral.sh/uv/install.sh | sh)

4. Установить драматурга:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

6. Добавьте нижеприведенный JSON в соответствующий редактор кода с ключом API

7. Перезапустите редактор кода.

🔃 Обновление

• uv cache clean

• обновить MCP сервер

    "web-eval-agent": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "webEvalAgent",
        "--from",
        "git+https://github.com/Operative-Sh/web-eval-agent.git",
        "webEvalAgent"
      ],
      "env": {
        "OPERATIVE_API_KEY": "<YOUR_KEY>"
      }
    }

Оперативный Discord-сервер

🛠️ Ручная установка (Mac + Cursor/Cline/Windsurf)

1. Получите свой ключ API на operative.sh

2. Установить УФ

curl -LsSf https://astral.sh/uv/install.sh | sh)

3. Установить драматурга:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

4. Добавьте нижеприведенный JSON в соответствующий редактор кода с ключом API

5. Перезапустите редактор кода.

Ручная установка (Windows + Cursor/Cline/Windsurf)

Мы дорабатываем этот вопрос. Если у вас возникнут какие-либо проблемы, пожалуйста, сообщите нам об этом!

1. Сделайте все это в терминале редактора кода.

2. curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Получите свой ключ API на operative.sh

4. Установить uv (curl -LsSf https://astral.sh/uv/install.sh | sh)

5. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install

6. Перезапустить редактор кода

🚨 Проблемы

• Обновления не приходят в редакторах кода, обновите или переустановите до последней версии: Запустите uv cache clean для последней версии

• Если у вас возникнут какие-либо проблемы, смело открывайте тему в этом репозитории или в Discord!

• 5/5 - статические приложения без изменений не транслировались на экран, исправлено! uv clean + перезапуск для исправления

Журнал изменений

• 29 апреля - Обновление наложения агента - пауза/воспроизведение/остановка работы агента в браузере

📋 Пример отчета о выводе сервера MCP

📊 Web Evaluation Report for http://localhost:5173 complete!
📝 Task: Test the API-key deletion flow by navigating to the API Keys section, deleting a key, and judging the UX.

🔍 Agent Steps
  📍 1. Navigate → http://localhost:5173
  📍 2. Click     "Login"        (button index 2)
  📍 3. Click     "API Keys"     (button index 4)
  📍 4. Click     "Create Key"   (button index 9)
  📍 5. Type      "Test API Key" (input index 2)
  📍 6. Click     "Done"         (button index 3)
  📍 7. Click     "Delete"       (button index 10)
  📍 8. Click     "Delete"       (confirm index 3)
🏁 Flow tested successfully – UX felt smooth and intuitive.

🖥️ Console Logs (10)
  1. [debug] [vite] connecting…
  2. [debug] [vite] connected.
  3. [info]  Download the React DevTools …
     …

🌐 Network Requests (10)
  1. GET /src/pages/SleepingMasks.tsx                   304
  2. GET /src/pages/MCPRegistryRegistry.tsx             304
     …

⏱️ Chronological Timeline
  01:16:23.293 🖥️ Console [debug] [vite] connecting…
  01:16:23.303 🖥️ Console [debug] [vite] connected.
  01:16:23.312 ➡️ GET /src/pages/SleepingMasks.tsx
  01:16:23.318 ⬅️ 304 /src/pages/SleepingMasks.tsx
     …
  01:17:45.038 🤖 🏁 Flow finished – deletion verified
  01:17:47.038 🤖 📋 Conclusion repeated above
👁️  See the "Operative Control Center" dashboard for live logs.

История Звезды

Создано с помощью <3 @ operative.sh