google-surf-mcp — MCP-сервер для Claude Code: поиск и установка
MCP-сервер ищет веб-страницы, статьи и код, а затем сохраняет результаты в локальном графе знаний проекта. Подходит для исследовательских задач и работы с кодовой базой.
claude mcp add --env SEARCH_API=<SEARCH_API> --env SURF_SEARCH_PROVIDER=<SURF_SEARCH_PROVIDER> --env SURF_SCHOLAR_PROVIDER=<SURF_SCHOLAR_PROVIDER> --env SURF_BROWSER_ENGINE=<SURF_BROWSER_ENGINE> --env CHROME_PATH=<CHROME_PATH> --transport stdio google-surf-mcp -- npx -y google-surf-mcpЧто делает google-surf-mcp
google-surf-mcp объединяет поиск Google, академических публикаций и GitHub-репозиториев. Результаты извлечения, планы, эксперименты и решения сохраняются в локальной памяти проекта. Для выдачи используются точный поиск, BM25, векторный поиск, связи кода и графовый поиск, после чего результаты объединяются через RRF и общий переранжировщик.
По умолчанию сервер запускает режим исследования и семь инструментов: search, search_parallel, extract, scholar_search, project_memory_search, project_memory и health. Он умеет связывать файлы, символы, импорты и вызовы через Tree-sitter, а граф экспортируется в HTML, Graphviz, D3 JSON и формат импорта Neo4j.
Браузерный поиск работает без API-ключа и использует системный Chrome; SearchApi можно подключить как основной или резервный провайдер. Для настройки доступны переменные SEARCH_API, SURF_SEARCH_PROVIDER, SURF_SCHOLAR_PROVIDER, SURF_BROWSER_ENGINE и CHROME_PATH. Без системного Chrome браузерный режим потребует настройки другого указанного движка.
Какие задачи решает
- искать веб-страницы, статьи и GitHub-репозитории
- извлекать текст и метаданные из HTML и PDF
- сохранять результаты исследования в памяти проекта
- находить связи между файлами, символами и вызовами
- экспортировать локальный граф знаний
Примеры запросов агенту
- Найди статьи и репозитории по теме распределённых очередей, затем сохрани результаты в памяти проекта.
- Извлеки текст и DOI из PDF по этой ссылке и свяжи источник с текущим проектом.
- Поищи в кодовой базе вызовы
createClientи покажи связанные файлы через граф.
Как установить google-surf-mcp
Командой платформы
claude mcp add --env SEARCH_API=<SEARCH_API> --env SURF_SEARCH_PROVIDER=<SURF_SEARCH_PROVIDER> --env SURF_SCHOLAR_PROVIDER=<SURF_SCHOLAR_PROVIDER> --env SURF_BROWSER_ENGINE=<SURF_BROWSER_ENGINE> --env CHROME_PATH=<CHROME_PATH> --transport stdio google-surf-mcp -- npx -y google-surf-mcpВместо <…> подставьте свои значения. Ещё 24 переменные окружения — в README сервера
Командой платформы
codex mcp add google-surf-mcp --env SEARCH_API=<SEARCH_API> --env SURF_SEARCH_PROVIDER=<SURF_SEARCH_PROVIDER> --env SURF_SCHOLAR_PROVIDER=<SURF_SCHOLAR_PROVIDER> --env SURF_BROWSER_ENGINE=<SURF_BROWSER_ENGINE> --env CHROME_PATH=<CHROME_PATH> -- npx -y google-surf-mcpВместо <…> подставьте свои значения. Ещё 24 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<CHROME_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 24 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"google-surf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<CHROME_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 24 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e SEARCH_API=<SEARCH_API> -e SURF_SEARCH_PROVIDER=<SURF_SEARCH_PROVIDER> -e SURF_SCHOLAR_PROVIDER=<SURF_SCHOLAR_PROVIDER> -e SURF_BROWSER_ENGINE=<SURF_BROWSER_ENGINE> -e CHROME_PATH=<CHROME_PATH> google-surf-mcp npx -y google-surf-mcpВместо <…> подставьте свои значения. Ещё 24 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о google-surf-mcp
Как установить google-surf-mcp в Claude Code?
Выполните `claude mcp add google-surf-mcp -e SEARCH_API=<SEARCH_API> -e GITHUB_TOKEN=<GITHUB_TOKEN> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e ORCAROUTER_API_KEY=<ORCAROUTER_API_KEY> -- npx -y google-surf-mcp`.
Что делает google-surf-mcp?
Он ищет веб-источники, научные статьи и код, извлекает содержимое и сохраняет его в локальном графе знаний проекта. Поиск учитывает свежие результаты и накопленную память.
Нужен ли API-ключ для браузерного поиска?
Нет, браузерный поиск использует системный Chrome без API-ключа. SearchApi подключается отдельно как основной или резервный провайдер.
