
google-surf-mcp
HarimxChoiv1.1.8MIT
303 звёзд32 форков
google-surf-mcp — это MCP-сервер для поиска в Google с помощью Playwright. Он использует тёплый профиль Chrome, который прогревается при первом запуске. Такой подход позволяет обходить капчу и блокировки без API-ключей и прокси. Сервер работает на вашем локальном компьютере и совместим с любыми MCP-клиентами.
Один сервер заменяет три: поисковый MCP, извлекатель URL и парсер академических PDF. Вам больше не нужно устанавливать и настраивать несколько разных MCP для работы с веб-контентом. Сервер протестирован на шести бесплатных MCP-поисковиках — они не работали. google-surf-mcp работает без проблем.
- Сервер сообщества
- Локальный запуск (stdio)
- TypeScript
- Лицензия MIT
- Обновлён 19 ноября 2026 г.
Подключение
Подключить google-surf-mcp
Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.
1
Способ подключения
2
Куда подключить
3
Скопируйте и проверьте
Claude Desktop / Claude Code
Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.
- 1.Откройте настройки MCP в Claude.
- 2.Добавьте сервер с указанной командой и переменными окружения.
- 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
]
}
}
}Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.
Характеристики
Общее
- СтатусСообщество
- РазработчикHarimxChoi
- Версияv1.1.8
- ЛицензияMIT
- Последний релиз19.11.2026
- Активность источника19.11.2026
Технологии
- ЯзыкиTypeScript
- Транспортstdio — локальный запуск
Описание
Возможности
- Поиск в Google: возвращает заголовки, ссылки и сниппеты.
- Параллельный поиск: выполняет до 10 запросов одновременно, ускоряя работу.
- Извлечение контента: получает текстовое содержимое любой веб-страницы по URL.
- Комбинированный инструмент
search_extract: ищет запрос и сразу извлекает содержимое найденных результатов. По умолчанию берёт абстракты (~1500 символов), но можно запросить полный текст. - Извлечение научных PDF: поддерживает arxiv, biorxiv, Nature, OpenReview, NeurIPS, JMLR, PMLR, Springer, PubMed. Извлекает текст статей прямо в ответ MCP.
- Фильтрация рекламы и панелей знаний: использует геометрическую проверку, а не просто сопоставление текста.
- Восстановление при CAPTCHA: четыре режима — уведомление ОС, отображение браузера, удалённая отладка, облачный режим (с быстрым завершением при ошибке).
- Автоматическая настройка профиля: первый вызов создаёт и прогревает профиль Chrome.
- Проверка здоровья: инструмент
healthвозвращает статус сервера и профиля.
Как подключить
Для установки выполните команду в терминале:
npx -y google-surf-mcp
Затем добавьте конфигурацию в MCP-клиент. Пример для Claude Desktop:
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": ["-y", "google-surf-mcp"]
}
}
}
После добавления перезапустите клиент. При первом вызове инструмента сервер создаст тёплый профиль Chrome. Вы можете управлять режимом работы через переменные окружения: SURF_HEADLESS=false для видимого браузера, SURF_CLOUD_MODE=true для окружений без браузера.
Примеры запросов
- «Найди последние новости по квантовым вычислениям» — используйте инструмент search.
- «Извлеки полный текст статьи с NeurIPS по трансформерам» — используйте search_extract с режимом full.
- «Выполни параллельный поиск по трём темам: TypeScript в 2025, лучшие практики React, новые фичи Node.js» — используйте search_parallel.
- «Проверь, работает ли сервер google-surf-mcp» — используйте health.
Технические детали
- Язык: TypeScript
- Транспорт: stdio
- Лицензия: MIT
- Не требует API-ключей и прокси
- Совместимость: все MCP-клиенты (Claude Desktop, Continue, Cursor, VS Code)
- Производительность: ~1,5 секунды на последовательный запрос, ~3 секунды на поиск с извлечением 5 результатов
- Репозиторий: github.com/HarimxChoi/google-surf-mcp




