Расширение Chrome · MCPv1.5.0 · MIT

Ваши агенты —в том Chrome, которым вы пользуетесь.

Расширение Chrome и небольшой локальный MCP-сервер. Claude Code, Codex, OpenCode или Cursor читают открытые вкладки, нажимают кнопки, заполняют формы, запускают скрипты и делают скриншоты — с вашими входами в аккаунты, а не в отдельном headless-браузере. Пока агент работает, страница светится и показывает, что происходит.

УстановитьОткрыть на GitHub
  • Работает только на 127.0.0.1
  • Без телеметрии
  • Бесплатно, открытый код

Повтор на примерных данных. Свечение и островок нарисованы стилями и словами самого расширения.

Как это работает

Агент → локальный сервер → ваши вкладки.

Агент запускает сервер как обычный MCP-сервер через stdio. Расширение подключается к нему на вашем же компьютере и делает работу во вкладке.

  1. Ваш агентClaude Code, Codex CLI, OpenCode, Cursor — любой MCP-клиент.
  2. Локальный MCP-серверNode.js, его запускает агент. Слушает 127.0.0.1:47615.
  3. Расширение ChromeПодключается только к этому порту. Показывает свечение и островок.
  4. Ваши вкладкиОткрытые страницы — с вашими cookies и входами.

Много сессий, один браузер

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

Вы всегда это видите

Пока агент действует во вкладке, её края «дышат» зелёным, а островок внизу пишет, что происходит. Он не перехватывает клики и гаснет вскоре после последнего вызова.

Понятные ошибки

Chrome закрыт — вызов сразу завершается понятной ошибкой. У каждого запроса таймаут 15 секунд, а клики и переходы никогда не повторяются у вас за спиной.

Инструменты

Двенадцать инструментов браузера.

В агенте они называются browser_* (в Claude Code — mcp__webmcp__browser_*).

ЧитатьВидеть то же, что вы.
  • browser_list_tabsВсе открытые вкладки: id, заголовок, url, какая активна.
  • browser_get_page_infoId, заголовок и url вкладки.
  • browser_get_page_contentВидимый текст или весь HTML страницы.
  • browser_query_selectorЭлементы по CSS-селектору: тег, текст, атрибуты.
  • browser_get_console_logsНакопленный вывод console.* и необработанные ошибки вкладки.
ДействоватьДелать то же, что вы.
  • browser_navigateОткрыть URL во вкладке.
  • browser_clickНажать первый элемент по селектору.
  • browser_fillЗаполнить input, textarea или contenteditable и вызвать input/change.
  • browser_upload_filesПоложить локальные файлы в <input type=file>.
Скрипты, скриншоты, статусОстальное.
  • browser_execute_scriptВыполнить JavaScript на странице и вернуть результат — даже на сайтах со строгим CSP.
  • browser_screenshotPNG видимой области, подсветка на это время скрыта.
  • browser_connection_statusПодключено ли расширение; хаб или пир; сколько сессий.

У каждого инструмента есть необязательный tabId; без него берётся активная вкладка последнего окна, в котором был фокус.

Установка

Установка в три шага.

Скачайте код с GitHub, установите сервер, загрузите расширение в Chrome.

Chrome Web Store — позже.

Нужны Node.js 22+ и Chrome (другие Chromium-браузеры с расширениями тоже должны подойти). Хотите настроить клиенты сами? npm install --ignore-scripts.

  1. 1

    Установите сервер

    git clone https://github.com/glmn-ai/neurosquad-browser-mcp.gitcd neurosquad-browser-mcp/servernpm install

    npm install заодно добавляет запись webmcp во все найденные MCP-клиенты — Claude Code, Codex CLI, OpenCode, Cursor. Существующую запись не перезаписывает и сохраняет копию .bak. Потом перезапустите эти клиенты.

  2. 2

    Загрузите расширение

    Пока его нет в Chrome Web Store, загрузите распакованным:

    • Откройте chrome://extensions
    • Включите «Режим разработчика» (справа вверху)
    • Нажмите «Загрузить распакованное» и выберите папку extension/
    • Закрепите NeuroSquad Browser MCP на панели
  3. 3

    Попросите агента

    Откройте страницу в Chrome и попробуйте:

    • > расскажи с помощью браузерных инструментов, что на текущей странице
    • > нажми кнопку «Отправить»
    • > введи «hello» в поиск и покажи ошибки из консоли
С кем работает

С любым агентом, который умеет MCP.

Установщик настраивает четыре клиента ниже. Вручную — добавьте stdio-сервер с именем webmcp, который запускает src/index.js сервера через Node.

Файл конфигурации:~/.claude.json
claude mcp add --scope user webmcp -- node /path/to/neurosquad-browser-mcp/server/src/index.js

Замените путь на папку, куда вы склонировали репозиторий.

В NeuroSquadКарточки агентов запускают те же CLI с вашими настройками, поэтому карточка Claude Code, Codex или OpenCode получает инструменты браузера из той же записи.
В nsqТо же в нашем терминальном приложении с открытым кодом: его агенты — ваши установленные CLI с вашими MCP-серверами.
Приватность и безопасность

Оно работает в вашем настоящем браузере. Вот как именно.

В этом весь смысл — и причина знать, что оно умеет, прежде чем подключать агента.

Агент может всё, что можете вы во вкладках, где вы вошли в аккаунты

Читать почту, нажимать кнопки, отправлять формы. Подключайте только агентов, которым доверяете, и следите за зелёным свечением.

Что остаётся на вашем компьютере

  • Расширение подключается к одному адресу: ws://127.0.0.1:47615. Ни аналитики, ни телеметрии, ни удалённого кода; шрифты и иконки — внутри расширения.
  • Хаб слушает только 127.0.0.1. Веб-страницам отказ (пускают только origin chrome-extension://); другим сессиям нужен случайный 256-битный токен из ~/.webmcp/peer-token.
  • Логи консоли хранятся в памяти хаба, по вкладкам и с ограничением объёма.

От чего оно не защищает

  • Что агент сделает с текстом страниц и скриншотами — в том числе отправит ли их своему провайдеру модели — решает сам агент.
  • Расширение не проверяет подлинность сервера: любая программа, запущенная от вашего пользователя, может поднять его на этом порту. Задайте WEBMCP_EXTENSION_IDS, чтобы принимать только вашу копию расширения.

Как остановить

  • Завершите сессию агента: его сервер выходит, когда закрывается клиент, и свечение гаснет.
  • Выключите расширение в chrome://extensions — тогда до вкладок не дотянется никто.
  • Удалите запись webmcp из конфигурации клиента, чтобы агенты больше не запускали сервер.

Каждое разрешение и зачем оно

Из манифеста расширения.
<all_urls>
Агенты работают на любой открытой у вас странице, поэтому расширению нужно читать и выполнять скрипты на любом сайте.
scripting
Чтение страницы, клики, заполнение полей, скрипты, отрисовка свечения и островка.
debugger
Только для скриптов на страницах, где CSP запрещает eval, и для полей выбора файлов. Подключается к одной вкладке на время вызова и сразу отключается; Chrome в это время показывает свою плашку.
tabs
Список вкладок, переходы, переключение на вкладку для скриншота.
activeTab
Снимок видимой вкладки для скриншота.
storage
Запомнить порт, заданный во всплывающем окне.
alarms
Будить service worker каждые 30 с, чтобы переподключаться к серверу.
Нашли проблему? Сообщите приватно — см. SECURITY.md.

Вопросы

Оно есть в Chrome Web Store?

Пока нет — страница в магазине появится позже. Сейчас папку extension/ загружают распакованной в chrome://extensions с включённым режимом разработчика. После обновления кода нажмите кнопку перезагрузки на карточке расширения и перезапустите сессии агентов.

Что-нибудь уходит с моего компьютера?

Расширение общается только с сервером на 127.0.0.1, а сервер — только с агентом, который его запустил. Телеметрии нет. Агент может отправить прочитанное своему провайдеру модели — это зависит от агента, которым вы пользуетесь.

С какими агентами работает?

С любым MCP-клиентом, который умеет запускать stdio-сервер. Установщик сам настраивает Claude Code, Codex CLI, OpenCode и Cursor; агенты в NeuroSquad и nsq используют те же конфигурации.

Почему мой Chrome, а не headless-браузер?

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

Можно запустить несколько агентов сразу?

Да. Каждая сессия запускает свой процесс сервера; все они делят одно подключение к расширению через хаб, а островок появляется в той вкладке, где идёт работа.

Раньше оно называлось WebMCP?

Да, переименовано в 1.4.0. Ключ в конфигурации по-прежнему webmcp; имена инструментов, порт 47615, переменные WEBMCP_* и файл токена не менялись, так что старые установки продолжают работать.

Пусть агент видит ту страницу, на которую смотрите вы.

Бесплатно, открытый код под MIT. Только локально.

УстановитьСкачать с GitHub

Запускайте несколько агентов рядом в NeuroSquad или в терминале с nsq