Chrome MCP Server

Что это?

Chrome MCP Server — это MCP-сервер, реализованный в виде расширения Chrome. Он предоставляет ИИ-ассистентам (например, Claude) возможность управлять вашим браузером: автоматизировать навигацию, анализировать содержимое страниц, делать скриншоты, выполнять семантический поиск по вкладкам и многое другое.

В отличие от инструментов вроде Playwright, решение работает с вашим обычным браузером, сохраняя все пользовательские настройки, расширения, историю и, что важно, сессии входа на сайты. Вам не нужно повторно авторизоваться — ИИ использует ваше текущее окружение.

Сервер работает полностью локально, все данные остаются на вашем устройстве.

Основные возможности

• Независимость от модели — совместим с любыми LLM и клиентами, поддерживающими MCP.
• Работа с родным браузером — используются ваши закладки, пароли, куки и настройки.
• Полная локальность — данные не покидают ваш компьютер.
• Streamable HTTP — поддерживается современный протокол потокового HTTP.
• Работа между вкладками — ИИ видит контекст всех открытых вкладок.
• Семантический поиск — встроенная векторная база данных для умного поиска по содержимому вкладок.
• SIMD-ускорение — операции с векторами выполняются в 4–8 раз быстрее благодаря WebAssembly.
• 20+ инструментов — скриншоты, мониторинг сети, управление закладками, история, взаимодействие с элементами и т. д.

Сравнение с Playwright-решениями

Быстрый старт

1. Установите расширение Chrome

1.1 Скачайте последнюю версию расширения с GitHub Releases.

1.2 Откройте Chrome и перейдите на страницу chrome://extensions/.

1.3 Включите «Режим разработчика».

1.4 Нажмите «Загрузить распакованное расширение» и выберите папку с загруженным расширением.

2. Установите пакет mcp-chrome-bridge

# npm
npm install -g mcp-chrome-bridge

# pnpm (рекомендуется)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridge

Примечание для pnpm: Если автоматическая регистрация не сработала, выполните mcp-chrome-bridge register.

3. Настройте MCP-клиента

🟢 Способ A: Streamable HTTP (рекомендуется)

Добавьте в конфигурацию вашего MCP-клиента (пример для CherryStudio):

{
  "mcpServers": {
    "chrome-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

🔵 Способ B: STDIO (если клиент не поддерживает HTTP)

Найдите путь к установленному пакету:

npm list -g mcp-chrome-bridge
# или
pnpm list -g mcp-chrome-bridge

Пример вывода: /Users/xxx/Library/pnpm/global/5

После этого укажите полный путь к скрипту mcp-server-stdio.js:

{
  "mcpServers": {
    "chrome-mcp-stdio": {
      "command": "npx",
      "args": [
        "node",
        "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"
      ]
    }
  }
}

4. Активируйте расширение

Нажмите на иконку расширения на панели инструментов Chrome, затем нажмите Connect — вы увидите готовую конфигурацию MCP.

Доступные инструменты

Полный список см. в документации.

Управление браузером (6)

• get_windows_and_tabs — список всех окон и вкладок.
• chrome_navigate — навигация по URL, управление viewport.
• chrome_close_tabs — закрытие вкладок/окон.
• chrome_go_back_or_forward — назад/вперёд.
• chrome_inject_script — внедрение скрипта в страницу.
• chrome_send_command_to_inject_script — отправка команд внедрённому скрипту.

Скриншоты (1)

• chrome_screenshot — скриншот с выбором элемента, поддержка полной страницы, кастомные размеры.

Мониторинг сети (4)

• chrome_network_capture_start / stop — захват через webRequest API.
• chrome_network_debugger_start / stop — захват с телами ответов через Debugger API.
• chrome_network_request — отправка произвольного HTTP-запроса.

Анализ контента (4)

• search_tabs_content — семантический поиск по содержимому всех вкладок.
• chrome_get_web_content — извлечение HTML/текста.
• chrome_get_interactive_elements — поиск кликабельных элементов.
• chrome_console — получение вывода консоли из вкладки.

Взаимодействие (3)

• chrome_click_element — клик по элементу (CSS-селектор).
• chrome_fill_or_select — заполнение форм, выбор опций.
• chrome_keyboard — симуляция ввода с клавиатуры.

Управление данными (5)

• chrome_history — поиск по истории с фильтром по времени.
• chrome_bookmark_search — поиск закладок.
• chrome_bookmark_add — добавление закладки с выбором папки.
• chrome_bookmark_delete — удаление закладок.

Примеры использования

Анализ страницы и рисование в Excalidraw

Подсказка: excalidraw-prompt

Пример запроса: «Помоги мне обобщить содержимое текущей страницы и нарисовать диаграмму для понимания».

Скриншот страницы или элемента

Запрос: «Сделай скриншот главной страницы Hugging Face» или «Сделай скриншот логотипа с главной страницы Hugging Face».

Автоматическое закрытие вкладок

Запрос: «Закрой все вкладки, связанные с shadcn».

Анализ истории браузера

Запрос: «Проанализируй мою историю за последний месяц».

Управление закладками

Запрос: «Добавь текущую страницу в закладки, поместив в подходящую папку».

Что дальше?

В планах развития:

• Аутентификация
• Запись и воспроизведение действий
• Автоматизация последовательностей (workflow)
• Поддержка Firefox

Следите за обновлениями проекта.

Участие в разработке

Мы приветствуем вклад сообщества. Пожалуйста, ознакомьтесь с CONTRIBUTING.md.

Лицензия

MIT — подробнее в LICENSE.

Полезные ссылки

• Архитектура
• Полная документация по API
• Решение проблем