searxng-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает метапоисковик SearXNG к ИИ-ассистентам по протоколу MCP. Позволяет искать данные через десятки поисковых систем прямо из контекста агента.
claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --transport stdio searxng-mcp -- docker run -i --rm -e SEARXNG_URL ghcr.io/aicrafted/searxng-mcp:latestЧто делает searxng-mcp
Сервер даёт агенту инструмент web_search для отправки поисковых запросов в работающий экземпляр SearXNG. Агрегатор опрашивает Google, DuckDuckGo, Brave, GitHub или ArXiv, собирая результаты в единый список. За счёт этого модель получает свежую информацию из сети без привязки к платному API отдельной поисковой системы.
Код запускается на Python 3.10+ либо в виде готового Docker-контейнера ghcr.io/aicrafted/searxng-mcp:latest. Поддерживаются три режима передачи данных: стандартный ввод-вывод stdio, протокол sse и stateless http. Конфигурация передаётся через аргументы командной строки или переменные окружения, главной из которых выступает SEARXNG_URL.
Без включения формата json в settings.yml самого SearXNG сервер сломается и не сможет прочитать результаты выдачи. Если сервис развёрнут за обратным прокси или на отдельном домене, защита Python SDK от DNS-ребиндинга потребует явно прописать адреса в MCP_ALLOWED_HOSTS и MCP_ALLOWED_ORIGINS.
Какие задачи решает
- находить свежую документацию и решения на GitHub или StackOverflow
- искать данные в сети без платных ключей коммерческих поисковых API
- фильтровать выдачу по тематическим категориям вроде news, science или it
- собирать результаты поиска сразу из нескольких поисковых движков
Примеры запросов агенту
- Найди через SearXNG обсуждения ошибки 421 в SDK MCP
- Сделай поиск по категории it о способах запуска searxng-mcp через docker compose
- Ищи на ArXiv статьи о расширении контекстного окна в больших моделях
Как установить searxng-mcp
Командой платформы
claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --transport stdio searxng-mcp -- docker run -i --rm -e SEARXNG_URL ghcr.io/aicrafted/searxng-mcp:latestВместо <…> подставьте свои значения
Командой платформы
codex mcp add searxng-mcp --env SEARXNG_URL=<SEARXNG_URL> -- docker run -i --rm -e SEARXNG_URL ghcr.io/aicrafted/searxng-mcp:latestВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"searxng-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"ghcr.io/aicrafted/searxng-mcp:latest"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"searxng-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEARXNG_URL",
"ghcr.io/aicrafted/searxng-mcp:latest"
],
"env": {
"SEARXNG_URL": "<SEARXNG_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SEARXNG_URL=<SEARXNG_URL> searxng-mcp docker run -i --rm -e SEARXNG_URL ghcr.io/aicrafted/searxng-mcp:latestВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о searxng-mcp
Как установить searxng-mcp в Claude Code?
Выполните команду claude mcp add --env SEARXNG_URL=<SEARXNG_URL> --transport stdio searxng-mcp -- docker run -i --rm -e SEARXNG_URL ghcr.io/aicrafted/searxng-mcp:latest, указав URL вашего сервера SearXNG.
Что делает searxng-mcp?
Он связывает клиент MCP с инстансом SearXNG, позволяя агенту выполнять веб-поиск и получать структурированные ответы из сотен источников.
Почему searxng-mcp не возвращает результаты?
В файле settings.yml вашего инстанса SearXNG в блоке search.formats должен быть добавлен формат json. Без него поисковик возвращает только HTML, который сервер не парсит.
