MCP Retrieval — MCP-сервер для Claude Code: веб-поиск и скрейпинг
MCP-сервер MCP Retrieval на Go с тремя инструментами: поиск по DuckDuckGo, картинки через Bing и скрейпинг страниц в Markdown. API-ключи не нужны.
MIT ★ 23 обновлён 2026-10-24
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_NAME=<MCP_NAME> --env MCP_PATH=<MCP_PATH> --env SERVER_PORT=<SERVER_PORT> --env SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> --transport stdio mcp-retrieval -- docker run -i --rm -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT ghcr.io/role1776/mcp-retrieval:0.1.10Что делает MCP Retrieval
Сервер отдаёт агенту три read-only инструмента: web_search ищет по DuckDuckGo Lite, web_search_images тянет картинки из Bing Images, web_scrape скачивает страницы и вытаскивает основной текст в Markdown. Каждый инструмент принимает список запросов или URL и выполняет их параллельно. Результат приходит как структурированный JSON, для клиентов без поддержки structuredContent SDK дублирует его в текстовый блок.
Запросы к поисковикам идут через библиотеку retrieval-go, которая маскируется под настоящий браузер на уровне TLS с помощью uTLS. Можно ротировать отпечатки браузеров и прокси, чтобы не словить капчу. Сервер работает в двух транспортах: stdio по умолчанию и http для удалённого запуска. Оба дают одинаковый набор инструментов.
Запуск — Docker-контейнер ghcr.io/role1776/mcp-retrieval:0.1.10, окружение задаётся переменными MCP_TRANSPORT, MCP_NAME, MCP_PATH, SERVER_PORT, SERVER_READ_TIMEOUT. Поисковые запросы ограничены 512 символами, URL — 2048 символами и только http/https. Дедупликация работает внутри одного запроса, а не между запросами в вызове: если два запроса нашли одну ссылку, она попадёт в оба результата.
Какие задачи решает
- найти свежие страницы по запросу без API-ключа
- скачать статью и вытащить из неё чистый текст для модели
- получить картинки по нескольким запросам за один вызов
- обойти базовую бот-защиту поисковиков
- запустить поиск удалённо через HTTP вместо stdio
Примеры запросов агенту
- Поищи в вебе свежие страницы про MCP-серверы и верни пять сниппетов.
- Скачай эту статью и отдай мне текст без ссылок, обрежь до 10000 символов.
- Найди картинки по запросу «архитектура Claude Code» за последнюю неделю.
Как установить MCP Retrieval
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_NAME=<MCP_NAME> --env MCP_PATH=<MCP_PATH> --env SERVER_PORT=<SERVER_PORT> --env SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> --transport stdio mcp-retrieval -- docker run -i --rm -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT ghcr.io/role1776/mcp-retrieval:0.1.10Вместо <…> подставьте свои значения. Ещё 18 переменных окружения — в README сервера
Командой платформы
codex mcp add mcp-retrieval --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_NAME=<MCP_NAME> --env MCP_PATH=<MCP_PATH> --env SERVER_PORT=<SERVER_PORT> --env SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> -- docker run -i --rm -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT ghcr.io/role1776/mcp-retrieval:0.1.10Вместо <…> подставьте свои значения. Ещё 18 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-retrieval": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"MCP_NAME",
"-e",
"MCP_PATH",
"-e",
"SERVER_PORT",
"-e",
"SERVER_READ_TIMEOUT",
"ghcr.io/role1776/mcp-retrieval:0.1.10"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"MCP_NAME": "<MCP_NAME>",
"MCP_PATH": "<MCP_PATH>",
"SERVER_PORT": "<SERVER_PORT>",
"SERVER_READ_TIMEOUT": "<SERVER_READ_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 18 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-retrieval": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_TRANSPORT",
"-e",
"MCP_NAME",
"-e",
"MCP_PATH",
"-e",
"SERVER_PORT",
"-e",
"SERVER_READ_TIMEOUT",
"ghcr.io/role1776/mcp-retrieval:0.1.10"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"MCP_NAME": "<MCP_NAME>",
"MCP_PATH": "<MCP_PATH>",
"SERVER_PORT": "<SERVER_PORT>",
"SERVER_READ_TIMEOUT": "<SERVER_READ_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 18 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e MCP_NAME=<MCP_NAME> -e MCP_PATH=<MCP_PATH> -e SERVER_PORT=<SERVER_PORT> -e SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> mcp-retrieval docker run -i --rm -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT ghcr.io/role1776/mcp-retrieval:0.1.10Вместо <…> подставьте свои значения. Ещё 18 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCP Retrieval
Как установить MCP Retrieval в Claude Code?
Выполни `claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env MCP_NAME=<MCP_NAME> --env MCP_PATH=<MCP_PATH> --env SERVER_PORT=<SERVER_PORT> --env SERVER_READ_TIMEOUT=<SERVER_READ_TIMEOUT> --transport stdio mcp-retrieval -- docker run -i --rm -e MCP_TRANSPORT -e MCP_NAME -e MCP_PATH -e SERVER_PORT -e SERVER_READ_TIMEOUT ghcr.io/role1776/mcp-retrieval:0.1.10`.
Что делает MCP Retrieval?
Даёт агенту три инструмента: поиск по DuckDuckGo, поиск картинок через Bing Images и скрейпинг страниц в Markdown. Каждый инструмент умеет обрабатывать список запросов или URL параллельно.
Нужны ли API-ключи для работы?
Нет. Поиск идёт через DuckDuckGo Lite и Bing Images без ключей, страницы скачиваются напрямую. Для обхода бот-защиты используется uTLS и ротация отпечатков браузера.