SearXNG HTTP MCP — MCP-сервер для Claude Code
Сервер MCP, который подключает SearXNG к агенту: поиск по 200+ движкам, категории, автодополнение. Работает из Docker или через uvx.
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Что делает 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+.
Какие задачи решает
- дать агенту веб-поиск без внешнего платного API
- искать сразу в новостях, картинках и видео по категориям
- поднять приватный поиск в Docker одним контейнером
- урезать выдачу, чтобы не забивать контекст модели
- подключить свой уже работающий SearXNG через
SEARXNG_URL
Примеры запросов агенту
- Найди в SearXNG свежие материалы про Docker healthcheck
- Покажи, какие поисковые движки доступны в категории «it»
- Подбери варианты запроса через автодополнение по слову «kubernetes»
Как установить SearXNG HTTP MCP
Командой платформы
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 mcp add searxng-http-mcp --env API_KEY=<API_KEY> -- docker run -i --rm -e API_KEY ghcr.io/whw23/searxng-http-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"searxng-http-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"API_KEY",
"ghcr.io/whw23/searxng-http-mcp"
],
"env": {
"API_KEY": "<API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 mcp add -e API_KEY=<API_KEY> searxng-http-mcp docker run -i --rm -e API_KEY ghcr.io/whw23/searxng-http-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SearXNG HTTP MCP
Как установить SearXNG HTTP MCP в Claude Code?
Одной командой: 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. Ключ подставьте свой.
Что делает SearXNG HTTP MCP?
Отдаёт агенту инструменты метапоиска через SearXNG: 200+ движков, 30+ категорий, автодополнение и список доступных движков по категориям.
Нужен ли отдельно установленный SearXNG?
Только для режима через uvx. Docker-образ самодостаточен: SearXNG уже собран внутри контейнера.
