mcpsurfr — MCP-сервер для Claude Code: что делает и как установить
Локальный веб-поиск для ИИ-агентов без ключей API: опрашивает поисковики через ddgs и сам ранжирует результаты на машине.
claude mcp add mcpsurfr -- docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1Что делает mcpsurfr
Сервер находит информацию в сети и отдаёт моделям готовые выжимки вместо целых страниц. Запросы идут через библиотеку ddgs, которая в режиме auto опрашивает несколько поисковиков одновременно. Среди поддерживаемых бэкендов есть DuckDuckGo, Brave, Wikipedia и Google. Если прямой поиск через Google блокируется, сервер сам переключается на запасные источники.
Ранжирование страниц происходит прямо на вашем компьютере с помощью небольшой модели MobileBERT на чистом numpy. Текст со страниц очищается от баннеров и навигации, сохраняя разметку таблиц и блоков кода. Инструмент search возвращает только подходящие абзацы с адресами источников. Это экономит контекстное окно модели.
Для запуска через готовый образ потребуется установленный Docker. При необходимости общий лимит символов для полностраничных инструментов настраивается через переменную окружения MCPSURFR_MAX_CHARS.
Какие задачи решает
- находить свежие факты в сети без покупки ключей к поисковым API
- извлекать из веб-страниц только нужные абзацы без рекламы и меню
- собирать информацию сразу из нескольких поисковых систем через deep_research
- сохранять разметку таблиц и фрагментов кода при чтении веб-страниц
Примеры запросов агенту
- Найди через mcpsurfr актуальные изменения в последнем релизе Go
- Запусти deep_research по теме архитектуры современных MCP-серверов
- Найди на Wikipedia статьи про историю языка Rust и выдели ключевые даты
Как установить mcpsurfr
Командой платформы
claude mcp add mcpsurfr -- docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1Командой платформы
codex mcp add mcpsurfr -- docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1Файл настроек
{
"mcpServers": {
"mcpsurfr": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nkapila6/mcpsurfr:v1.1.1"
]
}
}
}Файл настроек
{
"servers": {
"mcpsurfr": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/nkapila6/mcpsurfr:v1.1.1"
]
}
}
}Командой платформы
gemini mcp add mcpsurfr docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcpsurfr
Как установить mcpsurfr в Claude Code?
Выполните команду в терминале:
claude mcp add mcpsurfr -- docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1
Нужны ли серверу mcpsurfr платные ключи API?
Ключи API не требуются, потому что поиск работает через библиотеку ddgs, опрашивающую общедоступные поисковые бэкенды вроде DuckDuckGo или Brave.
Что делать, если Google блокирует поисковые запросы?
Сервер отслеживает подобные сбои и автоматически переключается на общий режим auto, распределяя запросы по другим поддерживаемым поисковикам.
