google-surf-mcp
MCP-сервер ищет в Google и Scholar, читает страницы и PDF и копит найденное в локальном графе знаний проекта
- 291 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер запускает Chrome, ходит в сеть и скачивает страницы, PDF и части репозиториев GitHub
- Результаты и прочитанные тексты автоматически сохраняются в локальную базу проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/google-surf-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер запускает Chrome, ходит в сеть и скачивает страницы, PDF и части репозиториев GitHub
- Результаты и прочитанные тексты автоматически сохраняются в локальную базу проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
google-surf-mcp ищет в интернете через системный Chrome с отдельным профилем без входа в аккаунт. Сервер дает агенту семь инструментов. Для поиска это search, search_parallel и scholar_search, для чтения страниц и PDF — extract. Память проекта обслуживают project_memory_search и project_memory, а health проверяет состояние. Все найденное и прочитанное попадает в локальную память текущего проекта, от веб-источников и статей до планов и решений. Из этого сервер строит граф знаний с онтологией и цепочкой происхождения данных. Код разбирает Tree-sitter, поэтому видны файлы, символы, импорты и вызовы. Поиск по памяти сочетает точное совпадение, BM25, векторы и граф, а результаты сервер сводит через RRF и общий реранкер. Проекты изолированы друг от друга, и связь между ними возникает только через совпадающие DOI, адреса репозиториев и явные алиасы. Граф можно проанализировать локально, например через PageRank и сообщества Louvain, и выгрузить для внешних инструментов. Отдельный необязательный хук для Codex сокращает слишком длинный вывод оболочки до записей, подходящих к запросу.
Для кого. Для исследователей и разработчиков, которые ведут долгие проекты с агентом и хотят искать в Google, читать статьи и копить найденное у себя на машине.
Подходит, если
- Агенту нужен поиск в Google без регистрации в платных поисковых API
- Исследование идет несколько сессий, и найденные источники, DOI и выводы надо сохранять в память проекта
- Нужно прочитать PDF или HTML-статью и получить название, авторов, DOI и текст
- Нужно искать по коду локального проекта и релевантных репозиториев GitHub: файлы, символы, импорты, вызовы
Не подходит, если
- Нужен поиск в Яндексе или другом сервисе: сервер работает с Google
- Нужна среда без Chrome или Chromium: режим браузерного поиска требует их
- Нужны только поиск и чтение без хранения: тогда задайте SURF_RESEARCH=false, иначе включается память и граф
- Нужны гарантированные результаты, даже когда Google показывает CAPTCHA: при блокировке браузерный поиск перестает работать
Пример запроса к агенту
Найди свежие статьи про retrieval-augmented generation, прочитай две самые релевантные и сохрани выводы в память проектаMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
SURF_RESEARCH- Значение false отключает память проекта и граф, поиск и чтение остаются.
SURF_SEARCH_PROVIDER- Провайдер поиска: browser, searchapi или fallback.
SEARCH_APIсекрет- Ключ SearchApi для режимов searchapi и fallback.
Ограничения
Нужны Node.js 20.18.1 или новее и Google Chrome либо Chromium. Первый вызов инструмента сам готовит профиль браузера, Chrome может ненадолго открыться; при сбое выполните npm run bootstrap. Запасной провайдер SearchApi требует собственный аккаунт, ключ в переменной SEARCH_API и кредиты. Память проекта лежит в локальной встроенной базе SurrealDB на RocksDB. Автор приводит скорость поиска 4,0–5,1 секунды на запрос, а сеть и ответ Google ее меняют.
Как отключить. Удалите запись google-surf из mcpServers в ~/.claude.json и перезапустите клиента. Если ставили хук Codex, выполните npx -y google-surf-mcp@latest hooks uninstall --host codex.
Частые вопросы
Как подключить google-surf-mcp к Claude Code?
Добавьте в ~/.claude.json запись google-surf с командой npx и аргументами -y google-surf-mcp, затем перезапустите Claude Code.
Нужен ли ключ API для поиска в Google?
Нет. По умолчанию поиск идет через браузер, а SearchApi подключается по желанию как основной или запасной провайдер через SURF_SEARCH_PROVIDER.
Как отключить память проекта?
Задайте SURF_RESEARCH=false. Поиск и чтение продолжат работать без базы и графа, а инструменты памяти не регистрируются.
Читает ли сервер мой профиль Chrome?
Нет. Он использует отдельный профиль без входа и не читает и не копирует ваш обычный профиль Chrome.
Можно ли выгрузить граф знаний?
Да. Граф выгружается в HTML, Graphviz, D3 JSON и формат импорта Neo4j, так что его можно открыть в браузере или загрузить в графовую базу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер объединенного поиска: один интерфейс к Tavily, Brave, Kagi, Exa, Linkup, Firecrawl и поиску по GitHub
MCP-сервер веб-поиска, который сразу отдает агенту текст найденных страниц: ответы Stack Overflow, обсуждения GitHub, статьи arXiv
MCP-сервер метапоиска: агент ищет текст, картинки, новости, видео и книги сразу по многим поисковикам и извлекает содержимое страниц
MCP-сервер поиска Яндекса и Google
web-compass
MCP-сервер веб-поиска и извлечения контента через Яндекс и Google на базе SerpAPI, с прицелом на результаты для России и СНГ
Веб-поиск через DuckDuckGo и чтение страниц для агента без API-ключей, с ограничением частоты запросов
Локальный MCP-сервер для исследований: поиск по вебу, Reddit и YouTube, карты и разбор кода для модели в LM Studio или Cursor
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| google-surf-mcp (эта запись) | нет | не нужна | 291 | |
| AnySearch MCP Server | нет | ключ необязателен | 2 052 | поиск в реальном времени по общим и вертикальным источникам, без локальной памяти проекта |
| CORE — память и задачи для Claude Code | нет | 2 007 | плагин с памятью решений и контекста проекта, без поиска в Google | |
| Bright Data Skills | да | 268 | скиллы Bright Data для поиска и сбора страниц через их облачный сервис |
Коротко о README
Автор называет проект автоматическим локальным графом знаний из поиска, статей и кода. Таблицы показывают скорость поиска и проверку реранкера.