# SearXNG HTTP MCP

Сервер MCP, который подключает SearXNG к агенту: поиск по 200+ движкам, категории, автодополнение. Работает из Docker или через uvx.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: whw23
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/whw23/searxng_http_mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/searxng-http-mcp

## Что делает

SearXNG HTTP MCP оборачивает метапоисковик SearXNG в один MCP-сервер: агент получает инструменты поиска с доступом к 200+ движкам и 30+ категориям вроде новостей, картинок и видео. Сами результаты обрезаны до сути, чтобы не жечь контекст. Автодополнение подсказывает формулировки запроса, а отдельный инструмент показывает, какие движки доступны по категориям.

Поднимается тремя способами. Docker-образ самодостаточен: SearXNG уже внутри, снаружи торчит один порт `8888` — на нём же живёт веб-интерфейс через обратный прокси, а `/mcp` уходит в FastMCP. Для локального режима тот же образ запускают с `--stdio`. Третий вариант — `uvx searxng-http-mcp`: он цепляется к вашему собственному экземпляру SearXNG по `SEARXNG_URL`, без него адрес по умолчанию `http://127.0.0.1:8080`.

Есть авторизация: `x-api-key` и HTTP Basic Auth. В примерах установки фигурирует переменная `API_KEY`, так что без ключа конфигурация из инструкции не заведётся. Pip-пакет требует Python 3.14+.

## Требования
- Нужно: Docker
- Переменные окружения: `API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env API_KEY=<API_KEY> --transport stdio searxng-http-mcp -- docker run -i --rm -e API_KEY ghcr.io/whw23/searxng-http-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add searxng-http-mcp --env API_KEY=<API_KEY> -- docker run -i --rm -e API_KEY ghcr.io/whw23/searxng-http-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "searxng-http-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "API_KEY",
                "ghcr.io/whw23/searxng-http-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "searxng-http-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "API_KEY",
                "ghcr.io/whw23/searxng-http-mcp"
            ],
            "env": {
                "API_KEY": "<API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e API_KEY=<API_KEY> searxng-http-mcp docker run -i --rm -e API_KEY ghcr.io/whw23/searxng-http-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- дать агенту веб-поиск без внешнего платного API
- искать сразу в новостях, картинках и видео по категориям
- поднять приватный поиск в Docker одним контейнером
- урезать выдачу, чтобы не забивать контекст модели
- подключить свой уже работающий SearXNG через `SEARXNG_URL`

## Примеры запросов агенту
- Найди в SearXNG свежие материалы про Docker healthcheck
- Покажи, какие поисковые движки доступны в категории «it»
- Подбери варианты запроса через автодополнение по слову «kubernetes»

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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