# oculo

Полноценный Chromium-браузер, которым управляет агент через MCP. Пригодится, когда нужно кликать по живым страницам, а не парсить их скриншотами.

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

## Что делает

Oculo — десктопный браузер на движке Chromium, который говорит на Model Context Protocol. Агент в Claude, Cursor, Windsurf или любом другом MCP-клиенте получает доступ к реальной странице: читает DOM, кликает, заполняет формы, вытаскивает данные. Ответы приходят текстом, а не мегабайтами скриншотов.

Внутри 12 инструментов: `page` описывает текущую страницу, `act` ходит по ссылкам и жмёт кнопки, `fill` заполняет поля, `read` вытаскивает таблицы и списки, `run` собирает многошаговый сценарий с условиями. Есть `media` для генерации картинок и видео, `shell` для команд, `research` для обхода нескольких вкладок. Логины хранятся в системном хранилище ключей через `electron.safeStorage`, пароль не покидает связку ключей ОС.

Oculo должен быть запущен — без него инструменты не сработают. Порт и токен доступа он пишет в `~/.oculo-port`, а мост `oculo-mcp` стучится туда по HTTP на порт 19516. Так сделано, потому что `<webview>` в Electron доступен только из renderer-процесса, где stdio не живёт.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Залогинься на github.com и поставь звезду репозиторию xidik12/oculo
- Заполни форму на example.com/contact и отправь её
- Собери все заголовки и ссылки с открытой страницы

## Похожие
- [Kernel MCP Server](https://affpapa.org/nevibecode/mcp/kernel-mcp-server.md) — MCP-сервер · ★ 38
- [fortress](https://affpapa.org/nevibecode/mcp/fortress.md) — MCP-сервер · ★ 777
- [PageMap](https://affpapa.org/nevibecode/mcp/pagemap.md) — MCP-сервер · ★ 36
- [browser-control](https://affpapa.org/nevibecode/skills/browser-control.md) — скилл · 1000 установок
- [setup-browser-cookies](https://affpapa.org/nevibecode/skills/setup-browser-cookies.md) — скилл · 342 установки
- [open-gstack-browser](https://affpapa.org/nevibecode/skills/open-gstack-browser.md) — скилл · 318 установок

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