Google Surf MCP

Google Surf MCP

HarimxChoiMIT
219 звёзд26 форков
google-surf-mcp — это MCP-сервер для поиска в Google с помощью Playwright. Он использует тёплый профиль Chrome, который прогревается при первом запуске. Такой подход позволяет обходить капчу и блокировки без API-ключей и прокси. Сервер работает на вашем локальном компьютере и совместим с любыми MCP-клиентами. Один сервер заменяет три: поисковый MCP, извлекатель URL и парсер академических PDF. Вам больше не нужно устанавливать и настраивать несколько разных MCP для работы с веб-контентом. Сервер протестирован на шести бесплатных MCP-поисковиках — они не работали. google-surf-mcp работает без проблем.
Подключение

Подключить Google Surf MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-surf-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Google Surf MCP

Google Surf MCP относится к Разработка, Поиск, Google Chrome, Браузеры, Playwright. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
TypeScript
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • РазработчикHarimxChoi
  • ЛицензияMIT

Технологии

  • Языки
    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

Поделиться