# MCP Retrieval

MCP-сервер MCP Retrieval на Go с тремя инструментами: поиск по DuckDuckGo, картинки через Bing и скрейпинг страниц в Markdown. API-ключи не нужны.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23 у репозитория
- Автор: Role1776
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Role1776/mcp-retrieval
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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`. Дедупликация работает внутри одного запроса, а не между запросами в вызове: если два запроса нашли одну ссылку, она попадёт в оба результата.

## Требования
- Нужно: Docker
- Переменные окружения: `MCP_TRANSPORT`, `MCP_NAME`, `MCP_PATH`, `SERVER_PORT`, `SERVER_READ_TIMEOUT`, `SERVER_WRITE_TIMEOUT`, `LOG_MODE`, `MAX_IDLE_CONNS_PER_HOST`, `MAX_QUERIES`, `DEFAULT_RESULTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- найти свежие страницы по запросу без API-ключа
- скачать статью и вытащить из неё чистый текст для модели
- получить картинки по нескольким запросам за один вызов
- обойти базовую бот-защиту поисковиков

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
