# zen-mcp

Управляет браузером Zen через протокол WebDriver BiDi по WebSocket. Пригодится для чтения веб-страниц, кликов по кнопкам и автозаполнения форм прямо из чата с агентом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 24
- Автор: sh6drack
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sh6drack/zen-mcp
- Обновлён: 2026-05-16
- HTML: https://affpapa.org/nevibecode/mcp/zen-mcp

## Что делает

Сервер связывает ИИ-ассистента с Zen Browser напрямую через WebSocket. Вместо тяжёлых прослоек вроде Selenium или Playwright здесь используется стандарт WebDriver BiDi. Инструмент умеет открывать вкладки, снимать скриншоты, считывать текстовое содержимое и выполнять произвольный JavaScript. Заполнение полей эмулирует события `input` и `change`, поэтому формы на React или Vue реагируют без сбоев.

В набор входит 20 инструментов для навигации и проверки элементов DOM. Повторные попытки соединения срабатывают автоматически. Без запущенного Zen с параметром `--remote-debugging-port 9222` сервер работать не сможет.

Для окружения требуется Node.js версии не ниже 20. Из-за особенностей текущей реализации BiDi в ядре Firefox тут нет перетаскивания элементов и загрузки локальных файлов. Если предыдущая сессия зависла, придётся перезапустить сам браузер через команду `killall zen && zen`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ZEN_DEBUG_PORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> --transport stdio zen-mcp -- npx -y zen-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add zen-mcp --env ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> -- npx -y zen-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zen-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "zen-mcp"
            ],
            "env": {
                "ZEN_DEBUG_PORT": "<ZEN_DEBUG_PORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "zen-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "zen-mcp"
            ],
            "env": {
                "ZEN_DEBUG_PORT": "<ZEN_DEBUG_PORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> zen-mcp npx -y zen-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- передавать агенту снимки экрана и текст страниц из Zen Browser
- заполнять поля ввода и отправлять веб-формы без Selenium и Playwright
- переключать вкладки и переходить по ссылкам внутри активной сессии браузера
- запускать скрипты JavaScript на открытой странице

## Примеры запросов агенту
- Открой новую вкладку в Zen Browser и покажи список интерактивных элементов на странице
- Сделай скриншот активной вкладки и извлеки из неё весь видимый текст
- Заполни форму авторизации на текущей странице и нажми кнопку подтверждения

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [apify-mcp-server](https://affpapa.org/nevibecode/mcp/apify-mcp-server.md) — MCP-сервер · ★ 12927

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md