# peek

peek даёт ИИ-агенту доступ к локальным записям браузерных сессий и помогает собрать воспроизводимый тест Playwright после ошибки.

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

## Что делает

peek подключает к ИИ-агенту локальные записи браузера: историю DOM, ошибки консоли и сети, а также действие пользователя перед сбоем. Сервер читает данные из SQLite и может превратить найденную сессию в запускаемый тест Playwright.

Сервер работает локально через stdio и не поднимает HTTP-точку. Запись сессий выполняет Chrome-расширение, а `@peekdev/cli` связывает его с MCP-сервером и создаёт каталог данных. Для начала записи нужно один раз запустить `peek init` и установить расширение.

Без Node.js 22 или новее установка нативной зависимости `better-sqlite3` может завершиться ошибкой, особенно на Windows. Это ограничение стоит проверить до подключения сервера.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add peek-mcp -- npx -y @peekdev/mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add peek-mcp -- npx -y @peekdev/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "peek-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@peekdev/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "peek-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@peekdev/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add peek-mcp npx -y @peekdev/mcp
```

## Когда брать
- найти сессию, где возникла ошибка
- собрать цепочку действия пользователя и сбоя
- проверить ошибки консоли и сетевые запросы
- получить воспроизводимый тест Playwright

## Примеры запросов агенту
- Найди последнюю записанную сессию с ошибкой в консоли и объясни, что произошло.
- Покажи сетевые ошибки и действие пользователя прямо перед сбоем в сессии.
- Сгенерируй тест Playwright, который воспроизводит ошибку из последней сессии.

## Похожие
- [troubleshooting](https://affpapa.org/nevibecode/skills/troubleshooting.md) — скилл · 3200 установок
- [browser-control](https://affpapa.org/nevibecode/skills/browser-control.md) — скилл · 1000 установок
- [playwright-in-sandbox](https://affpapa.org/nevibecode/skills/playwright-in-sandbox.md) — скилл · 508 установок
- [Web Browser (kogiQA)](https://affpapa.org/nevibecode/mcp/web-browser-kogiqa.md) — MCP-сервер · ★ 91
- [mcp-accessibility-scanner](https://affpapa.org/nevibecode/mcp/mcp-accessibility-scanner.md) — MCP-сервер · ★ 59
- [browser-trace](https://affpapa.org/nevibecode/skills/browser-trace.md) — скилл · 3000 установок

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