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

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

Демо

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

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

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

🌐 Навигация по веб-приложению с помощью BrowserUse (в 2 раза быстрее с работающим бэкэндом)
📊 Захват сетевого трафика — запросы интеллектуально фильтруются и возвращаются в контекстное окно
🚨 Собирайте ошибки консоли — записывайте логи и ошибки
🤖 Автономная отладка — агент курсора вызывает сервер mcp веб-агента контроля качества, чтобы проверить, работает ли написанный им код так, как ожидалось, от начала до конца.

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

Инструмент

Цель

web_eval_agent

🤖 Автоматизированный оценщик UX, который управляет браузером, делает снимки экрана, ведет журналы консоли и сети и возвращает подробный отчет о UX.

setup_browser_state

🔒 Открывает интерактивный (не headless) браузер, позволяющий войти в систему один раз; сохраненные файлы cookie/локальное хранилище повторно используются при последующих запусках

web_eval_agent

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

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)

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

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

Запустите установщик после получения ключа API (бесплатно)
- Устанавливает драматурга
- Устанавливает УФ
- Вставляет JSON в ваш редактор кода (Cursor/Cline/Windsurf)!

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

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

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

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

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

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

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

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

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

🔃 Обновление

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)

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

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

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

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

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

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

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

Сделайте все это в терминале редактора кода.
curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh
Получите свой ключ API на operative.sh
Установить uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
Перезапустить редактор кода

🚨 Проблемы

Обновления не приходят в редакторах кода, обновите или переустановите до последней версии: Запустите 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

Deploy Server

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Tools

Related MCP Servers

MCP Puppeteer Linux Server
PhialsBasement
A
security
-
license
A
quality
Enables browser automation for LLMs on Linux display servers, supporting web interaction, screenshots, and JavaScript execution in a real browser.
Last updated -
7
0
7
Mentor MCP Server
cyanheads
A
security
-
license
A
quality
Provides LLM Agents with AI-powered mentorship for code review, design critique, writing feedback, and brainstorming using the Deepseek API, enabling enhanced output in various development and strategic planning tasks.
Last updated -
32
Apache 2.0
Web-QA
GroundNG
-
security
-
license
-
quality
AI-powered agent that streamlines web testing workflows by allowing developers to record, execute, and discover tests using natural language prompts in their AI coding assistants.
Last updated -
59
Apache 2.0
Safari MCP Server
lxman
A
security
-
license
A
quality
Provides AI assistants with Safari browser automation and developer tools access, enabling LLMs to control Safari, access console logs, monitor network activity, and perform browser automation tasks.
Last updated -
13
5
9
MIT License

View all related MCP servers

WebEvalAgent MCP Server