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 работает без проблем.
DevelopmentSearchChromeBrowserPlaywright
Открыть на GitHub

Установка

npx -y google-surf-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться