Browser MCP Server Template
Allows automation of Brave browser, supporting navigation, element interaction, screenshots, and stealth mode via Puppeteer.
Provides basic support for automating Firefox browser with navigation, clicking, typing, and other browser control features.
Enables full automation of Google Chrome, including profile management, cookie handling, stealth anti-detection, and debugging.
Allows automation of Opera browser with navigation, element interaction, screenshots, and profile support.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Browser MCP Server TemplateGo to example.com and take a screenshot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Browser MCP Server Template
Шаблон MCP сервера для автоматизации браузера. Работает с любой LLM, поддерживающей MCP (Claude, GPT, Gemini, Mistral и др.).
Возможности
Функция | Описание |
Stealth Mode | Анти-детекция через puppeteer-extra-plugin-stealth |
Авто-профиль | Автоматический поиск профиля с куками |
Подключение | К подключению к уже запущенному браузеру |
16 evasions | Маскировка под обычный браузер |
Stealth Mode (защита от капчи)
Сервер использует puppeteer-extra-plugin-stealth для обхода проверок на автоматизацию:
Скрывает
navigator.webdriverДобавляет
chrome.runtimeЭмулирует plugins, languages, permissions
Маскирует User-Agent
И многое другое
// Проверить stealth mode
browser_check_stealth()
// Тест на bot.sannysoft.com
browser_navigate({ url: "https://bot.sannysoft.com/" })Related MCP server: Playwright Browserbase MCP Server
Поддерживаемые браузеры
Браузер | Статус | Примечание |
Google Chrome | ✅ | Рекомендуется |
Chromium | ✅ | |
Microsoft Edge | ✅ | |
Brave | ✅ | |
Opera | ✅ | |
Firefox | ⚠️ | Базовая поддержка |
Автоматически находит установленный браузер. Приоритет: Chrome > Chromium > Edge > Brave > Opera > Firefox.
Установка
cd /root/browser-mcp-template
npm install
# Установить Chrome/Chromium (если нужно)
npx puppeteer browsers install chromeУказание конкретного браузера
Через переменную окружения:
export PUPPETEER_EXECUTABLE_PATH="/usr/bin/firefox"Использование
Claude Desktop
Добавить в ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"browser": {
"command": "node",
"args": ["/root/browser-mcp-template/index.js"]
}
}
}Claude Code (CLI)
claude mcp add browser node /root/browser-mcp-template/index.jsCursor / Windsurf / VS Code
Добавить в настройки MCP:
{
"mcpServers": {
"browser": {
"command": "node",
"args": ["/path/to/browser-mcp-template/index.js"]
}
}
}Доступные инструменты
Навигация и управление
Инструмент | Описание |
| Открыть URL (с выбором браузера и профиля) |
| Кликнуть по элементу |
| Ввести текст в поле |
| Сделать скриншот |
| Получить текст элемента |
| Получить HTML элемента |
| Выполнить JavaScript |
| Ждать элемент или время |
| Выбрать опцию в dropdown |
| Прокрутить страницу |
| Навести курсор на элемент |
| Загрузить файл |
| Нажать клавишу |
Вкладки и информация
Инструмент | Описание |
| Список открытых вкладок |
| Переключить вкладку |
| URL и заголовок страницы |
| Информация о браузере |
| Проверить stealth mode |
| Закрыть браузер |
Профили и куки
Инструмент | Описание |
| Автодетект профиля с куками и запуск браузера |
| Список доступных профилей браузера |
| Определить какой профиль используется |
| Получить куки текущей сессии |
| Установить куки |
| Удалить куки |
| Подключиться к уже запущенному браузеру |
| Запустить браузер с отладочным портом |
Работа с профилями
Автодетект профиля (самый простой способ!)
// Автоматически найдет профиль с куками и запустит браузер
browser_auto_connect({
browser: "chrome",
url: "https://github.com" // опционально
})
// Или через browser_navigate с profile="auto"
browser_navigate({
url: "https://github.com",
profile: "auto" // автодетект профиля
})Сервер автоматически:
Ищет профили Chrome/Firefox/Edge/Brave в стандартных путях
Читает
Local Stateчтобы найти последний использованный профильПроверяет наличие Cookies файлов
Запускает браузер с найденным профилем
Подключение к уже запущенному браузеру (самый простой способ!)
Если Chrome уже открыт с авторизацией, подключитесь к нему:
# 1. Запустите Chrome с отладочным портом (один раз)
google-chrome --remote-debugging-port=9222
# 2. Подключитесь через MCP
browser_connect({ port: 9222 })Или запустите браузер через MCP:
browser_start_with_debug({
browser: "chrome",
port: 9222,
profile: "default" // использовать существующий профиль
})
// Затем подключитесь
browser_connect({ port: 9222 })Важно: При browser_close() сервер отключится от браузера, но НЕ закроет его — вы сможете продолжать работу в браузере вручную.
Авто-определение активного профиля
// Определить какой профиль используется
browser_detect_active_profile({ browser: "chrome" })
// Вернет: имя профиля, путь, есть ли куки, запущен ли браузерИспользование реального профиля (с куками и авторизацией)
// Использовать основной профиль Chrome (все куки и сессии)
browser_navigate({
url: "https://github.com",
profile: "default"
})
// Использовать конкретный профиль
browser_navigate({
url: "https://github.com",
profile: "default",
profileName: "Profile 1"
})
// Указать кастомный путь к профилю
browser_navigate({
url: "https://github.com",
profile: "custom",
profilePath: "/home/user/.config/google-chrome"
})
// Без профиля (чистая сессия)
browser_navigate({
url: "https://github.com",
profile: "none"
})Просмотр доступных профилей
// Найти все профили Chrome
browser_list_profiles({ browser: "chrome" })
// Определить активный профиль
browser_detect_active_profile({ browser: "chrome" })Работа с куками
// Посмотреть все куки
browser_get_cookies()
// Куки для конкретного домена
browser_get_cookies({ url: "https://github.com" })
// Установить куку
browser_set_cookie({
name: "session",
value: "abc123",
domain: ".github.com"
})
// Удалить куку
browser_delete_cookie({
name: "session",
domain: ".github.com"
})Переменные окружения
# Указать путь к профилю
export BROWSER_PROFILE_PATH="~/.config/google-chrome"
# Указать путь к браузеру
export PUPPETEER_EXECUTABLE_PATH="/usr/bin/google-chrome"Пример использования (промпт для LLM)
Открой GitHub с моим профилем (profile="default"), найди мой репозиторий и создай новый issue.Зайди на сайт с авторизацией. Используй profile="default" чтобы сохранить сессию.
После входа получи куки и сохрани их.Автоматизация (пример)
# Пример цепочки действий через MCP:
1. browser_navigate(url="https://github.com", profile="default")
2. browser_click(selector="a[href='/login']")
3. browser_wait(selector="input[name='login']", timeout=5000)
4. browser_type(selector="input[name='login']", text="myuser")
5. browser_type(selector="input[name='password']", text="mypass")
6. browser_click(selector="input[type='submit']")
7. browser_wait(selector=".dashboard", timeout=10000)
8. browser_screenshot()Требования
Node.js 18+
Один из браузеров: Chrome, Chromium, Edge, Brave, Opera или Firefox
~200MB места для браузера
Автоопределение браузера
Сервер автоматически ищет браузеры в стандартных путях:
/usr/bin/google-chrome/snap/bin/chromium/usr/bin/microsoft-edge/usr/bin/brave-browser/usr/bin/firefox
Автоопределение профилей
Сервер ищет профили в стандартных путях:
Chrome:
~/.config/google-chrome,~/.config/chromiumFirefox:
~/.mozilla/firefoxEdge:
~/.config/microsoft-edgeBrave:
~/.config/BraveSoftware/Brave-Browser
Укажите BROWSER_PROFILE_PATH если профили в нестандартном месте.
Важно
При использовании реального профиля не запускайте браузер дважды — это может повредить данные. Если браузер уже открыт, закройте его вручную перед использованием MCP сервера.
Лицензия
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZuccaMuka/browser-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server