ofershap/real-browser-mcp

ofershap/real-browser-mcp

от ofershap
MCP-сервер и Chrome-расширение, которые подключают AI-агента к вашему реальному браузеру — с сохранёнными сессиями и куками. Разработчики могут поручать агенту клики, ввод текста, скриншоты и прове...

Real Browser MCP

real-browser-mcp

The missing piece in AI coding: your agent can now see your REAL browser.

Chrome Extension   MCP Server   Add to Cursor   Agent Rules

CI npm version npm downloads License: MIT TypeScript

Demo


You ship a fix. Your agent says "done, please verify." You alt-tab to Chrome, navigate to the page, log in, click around, find the bug.

Your agent just wrote the code. It could also verify it. It already has your browser open right there. It just can't see it.

Now it can.

Real Browser MCP


Quick Start

Two parts:

  • MCP server - runs on your machine, talks to your AI agent
  • Chrome extension - sits in your browser, executes the commands
1. Add the MCP server

Cursor (one click):

Install in Cursor

Or add manually in Cursor Settings > MCP > "Add new MCP server":

{
  "mcpServers": {
    "real-browser": {
      "command": "npx",
      "args": ["-y", "real-browser-mcp"]
    }
  }
}
Claude Desktop, Windsurf, or other MCP clients

Claude Desktop: Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Add the same JSON block.

Инструменты были проиндексированы:
browser_click

Кликает на элемент на странице, используя ref из snapshot или CSS-селектор.

Параметры
  • buttonenum
  • doubleClickboolean
  • refstring

    Element reference from snapshot (e.g. "e12")

  • selectorstring

    CSS selector for the element

browser_click_text

Кликнуть по элементу по его видимому текстовому содержимому. Работает с выпадающими списками, порталами и наложениями React, которые могут не отображаться в снимках. Безопасен для CSP (без eval). Предпочитает самый глубокий подходящий элемент.

Параметры
  • exactboolean

    Require exact match instead of substring (default false)

  • indexnumber

    Which match to click if multiple (0-based, default 0)

  • textstringобязательный

    Text to match against element content (first line)

browser_console

Читает сообщения консоли (log, warn, error) из браузера

Параметры
  • clearboolean

    Clear messages after reading

browser_evaluate

Выполняет JavaScript на странице и возвращает результат. Используйте для DOM-запросов, чтения состояния страницы или любых операций, не охваченных другими инструментами.

Параметры
  • expressionstringобязательный

    JavaScript expression or code to evaluate in the page context

browser_find

Находит элементы на странице с помощью естественного языка (например, "кнопка входа", "поле поиска"). Возвращает ссылки, которые можно использовать с click/type.

Параметры
  • limitnumber

    Max matches to return

  • querystringобязательный

    Natural language description of what to find

browser_handle_dialog

Обрабатывает диалоговые окна JavaScript (alert, confirm, prompt). Диалоговые окна блокируют взаимодействие со страницей, пока их не обработают.

Параметры
  • actionenumобязательный

    Accept or dismiss the dialog

  • promptTextstring

    Text to enter for prompt() dialogs

browser_hover

Наведение курсора на элемент вызывает всплывающие подсказки, выпадающие меню или состояния наведения.

Параметры
  • refstring

    Element reference from snapshot

  • selectorstring

    CSS selector for the element

browser_navigate

Перейти по URL в активной вкладке браузера

Параметры
  • urlstringобязательный

    The URL to navigate to

  • waitUntilenum

    When to consider navigation complete

browser_network

Читать сетевые запросы, сделанные страницей. Фильтровать по шаблону URL.

Параметры
  • clearboolean

    Clear requests after reading

  • filterstring

    URL regex pattern to filter requests

browser_press_key

Нажимает клавишу или комбинацию клавиш (Enter, Escape, Tab, ArrowDown и т.д.). Поддерживает модификаторы, такие как Ctrl+A, Cmd+C.

Параметры
  • keystringобязательный

    Key name (e.g. "Enter", "Escape", "Tab", "ArrowDown", "a")

  • modifiersenum[]

    Modifier keys to hold

  • refstring

    Element ref to focus before pressing

  • selectorstring

    CSS selector to focus before pressing

browser_screenshot

Захватывает снимок экрана видимой области страницы

Параметры
  • formatenum
  • qualitynumber

    JPEG quality (ignored for PNG)

browser_scroll

Прокручивает страницу или элемент. Поддерживает сдвиги в пикселях, прокрутку к элементам и именованные позиции (верх/низ). Работает с виртуальными контейнерами прокрутки, которые используются в социальных сетях.

Параметры
  • amountnumber

    Pixels to scroll

  • directionenum
  • positionenum

    Scroll to top or bottom of page

  • selectorstring

    CSS selector of scroll container (for virtual scroll)

  • toElementstring

    Ref or CSS selector to scroll into view

browser_select

Выбирает опцию из выпадающего списка (dropdown/select element).

Параметры
  • indexnumber

    Option index to select (0-based)

  • labelstring

    Option label text to select

  • refstring

    Element reference from snapshot

  • selectorstring

    CSS selector for the select element

  • valuestring

    Option value to select

browser_snapshot

Получает снимок дерева доступности страницы. Возвращает ссылки на элементы, которые вы можете использовать с click, type и другими инструментами. Используйте компактный режим (по умолчанию) для меньшего вывода - только интерактивные элементы.

Параметры
  • compactboolean

    When true (default), returns only interactive elements with minimal nesting. Set false for full tree.

  • selectorstring

    CSS selector to scope the snapshot

browser_tabs

Управляет вкладками браузера: перечисляет, создаёт, закрывает или фокусирует

Параметры
  • actionenumобязательный

    Tab action

  • tabIdnumber

    Tab ID for close/focus

  • urlstring

    URL for create action

browser_text

Извлекает неформатированное текстовое содержимое со страницы или из указанного элемента

Параметры
  • maxLengthnumber

    Max text length to return

  • selectorstring

    CSS selector to scope text extraction

browser_type

Введите текст в элемент ввода.

Параметры
  • clearboolean

    Clear the field before typing

  • refstring

    Element reference from snapshot

  • selectorstring

    CSS selector for the input

  • textstringобязательный

    Text to type

browser_wait

Ожидание условия: появление элемента, исчезновение элемента или фиксированная задержка. Полезно для SPA и динамического контента.

Параметры
  • delaynumber

    Fixed delay in ms (ignores selector)

  • selectorstring

    CSS selector to wait for

  • stateenum

    Wait until element is visible, hidden, or attached to DOM

  • timeoutnumber

    Max wait time in ms

Похожие MCP-сервера

achiya-automation/safari-mcp

achiya-automation/safari-mcp

Используйте Safari MCP сервер для AI-агентов на macOS - ваш реальный браузер с сессиями, куками и 96 инструментами. Работает без Chrome, на нативном WebKit, с низким нагревом.

JavaScript183
webdriverio/mcp

webdriverio/mcp

официальный

Управляйте браузерами и мобильными приложениями через WebDriverIO с MCP-сервером. Автоматизируйте Chrome, Firefox, Edge, Safari, iOS и Android: навигация, клики, скриншоты. Оптимален для тестирования.

TypeScript38
freema/firefox-devtools-mcp

freema/firefox-devtools-mcp

MCP-сервер от Mozilla для автоматизации Firefox через WebDriver BiDi. Позволяет ИИ-агентам (Claude, Cursor) управлять браузером: навигация, скриншоты и работа с консолью/сетью. Полезен разработчика...

TypeScript401
LeonTing1010/tap

LeonTing1010/tap

Taprun — MCP сервер для локальной автоматизации браузера: AI компилирует детерминированный .plan.json, а сервер воспроизводит его вечно с нулевыми затратами токенов. Куки и сессии остаются в вашем ...

JavaScript17
Playwright MCP

Playwright MCP

официальный

MCP сервер для браузерной автоматизации на основе Playwright. Использует structured accessibility snapshots вместо скриншотов, что делает его быстрым и LLM-friendly. Подходит для агентов, тестирования и автономных сценариев без vision-моделей.

TypeScript36983
automatalabs/mcp-server-playwright

automatalabs/mcp-server-playwright

Сервер для автоматизации браузера через Playwright: позволяет ИИ-агентам открывать страницы, делать скриншоты, кликать, заполнять формы и выполнять JavaScript — полезен для тестирования и сбора данных.

JavaScript299
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин