searxng-mcp

MCP-сервер для SearXNG, который делает вывод для моделей кратким, сохраняет полные результаты в скрытых метаданных и поддерживает как локальные клиенты stdio, так и развертывание через streamable-http.

Что вы получаете

• search для краткого веб-поиска с полными необработанными данными в _meta

• search_many для параллельного веерного поиска, дедупликации и объединенного ранжирования

• search_and_fetch для поиска и извлечения источников за один вызов

• research для поиска по нескольким запросам с пакетной загрузкой и объединенными источниками

• fetch_url для извлечения читаемого контента страниц с цитатами

• fetch_many для параллельного извлечения URL с кэшированием

• health для проверки состояния бэкенда, кэша и рендеринга

Сервер спроектирован как легковесный. SearXNG выполняет работу по поиску; searxng-mcp управляет инструментами, кэшированием, извлечением и транспортом.

Related MCP server: SearXNG MCP Bridge

Быстрый старт

Установка из репозитория

uv sync
uv run searxng-mcp

Установка с помощью uvx

searxng-mcp распространяется из этого репозитория (релиза в PyPI нет). Самый быстрый путь:

uvx --from git+https://github.com/88plug/searxng-mcp searxng-mcp

Рендеринг при извлечении включен в установку по умолчанию. Если в системе уже есть Chromium или Chrome, searxng-mcp будет использовать их. В противном случае первый рендеринг автоматически загрузит Playwright Chromium в кэш пользователя.

Запуск через Docker

docker build -t searxng-mcp .
docker run --rm -p 8811:8811 --add-host=host.docker.internal:host-gateway \
  -e SEARXNG_MCP_BASE_URL=http://host.docker.internal:8890 \
  searxng-mcp

Пример для Claude Desktop

{
  "mcpServers": {
    "searxng-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/88plug/searxng-mcp", "searxng-mcp"],
      "env": {
        "SEARXNG_MCP_BASE_URL": "http://127.0.0.1:8890",
        "SEARXNG_MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Режимы развертывания

Локальный stdio

Используйте этот режим для настольных клиентов и частных рабочих процессов. Это самый простой и безопасный вариант.

SEARXNG_MCP_TRANSPORT=stdio uv run searxng-mcp

Потоковый HTTP

Используйте этот режим для частного сервиса, командного развертывания или внутреннего эндпоинта за обратным прокси-сервером.

SEARXNG_MCP_TRANSPORT=streamable-http uv run searxng-mcp --host 0.0.0.0 --port 8811

Усиленный Docker и Compose

Для долгосрочного самохостинга используйте усиленный вариант контейнера и предоставленный стек Compose.

docker build -f Dockerfile.prod -t searxng-mcp:prod .
cp docker-compose.env.example .env
docker compose up --build -d

Безопасность и доверие

Этот проект безопасен для локального использования и использования в доверенных сетях. Он не является готовым публичным интернет-сервисом.

• fetch_url и fetch_many могут извлекать произвольные URL, предоставленные клиентом

• рендеринг при извлечении может запускать Chromium для обработки ненадежных страниц

• streamable-http следует защитить аутентификацией или обратным прокси-сервером при любом совместном развертывании

• SEARXNG_MCP_FETCH_VERIFY_TLS=0 предназначен только для частных или самоподписанных настроек бэкенда

Если вы открываете HTTP-транспорт, относитесь к нему как к внутреннему сервису и добавьте средства контроля, ожидаемые для любого инструмента, способного к SSRF.

Зачем это нужно

• компактный вывод для моделей с сохранением всех деталей в скрытых метаданных

• ускорение исследовательских рабочих процессов за счет параллельного поиска и веерного извлечения

• рендеринг для страниц с активным использованием JS без дополнительных флагов установки

• возможность самохостинга для тех, кому нужен собственный MCP-сервер на базе SearXNG

Интерфейс MCP

• searxng://config открывает текущие настройки, режим транспорта и поддержку рендеринга

• searxng://guide суммирует доступные инструменты и случаи их использования

• quick_lookup, deep_research и research_workflow — это опциональные подсказки совместимости для клиентов, поддерживающих поверхности промптов

Окружение

Ключевые переменные:

• SEARXNG_MCP_BASE_URL: базовый URL SearXNG, по умолчанию http://127.0.0.1:8890

• SEARXNG_MCP_FALLBACK_BASE_URLS: опциональные резервные экземпляры SearXNG, разделенные запятыми

• SEARXNG_MCP_TRANSPORT: stdio, streamable-http или sse

• SEARXNG_MCP_SEARCH_TIMEOUT: таймаут поиска на бэкенде в секундах

• SEARXNG_MCP_FETCH_TIMEOUT: таймаут извлечения в секундах

• SEARXNG_MCP_SEARCH_CACHE_TTL: TTL кэша поиска в секундах

• SEARXNG_MCP_FETCH_CACHE_TTL: TTL кэша извлечения в секундах

• SEARXNG_MCP_FETCH_VERIFY_TLS: установите 0 для пропуска проверки TLS при извлечении

• SEARXNG_MCP_RENDER_TIMEOUT: таймаут навигации браузера для рендеринга

• SEARXNG_MCP_RENDER_WAIT_MS: дополнительное ожидание после загрузки DOM для рендеринга

• SEARXNG_MCP_RENDER_CONCURRENCY: лимит параллельного рендеринга

• SEARXNG_MCP_RENDER_HEADLESS: установите 0 для отображения браузера

• SEARXNG_MCP_RENDER_BROWSER_PATH: явный путь к бинарному файлу Chromium или Chrome

• SEARXNG_MCP_RENDER_SANDBOX: установите 1 для включения песочницы Chromium

• SEARXNG_MCP_RENDER_BLOCK_RESOURCES: установите 0 для разрешения изображений, шрифтов, стилей и медиа при рендеринге

• SEARXNG_MCP_RENDER_AUTO_FALLBACK: установите 0 для отключения автоматического резервного рендеринга

• SEARXNG_MCP_RENDER_AUTO_MIN_WORDS: уменьшите для более агрессивного авто-рендеринга

• SEARXNG_MCP_RENDER_AUTO_MIN_CHARS: уменьшите для более агрессивного авто-рендеринга

• SEARXNG_MCP_CACHE_DIR: путь к директории кэша

Бенчмарки

uv run searxng-mcp-bench --rounds 3

Отчеты бенчмарков включают:

• задержку необработанного бэкенда SearXNG

• размер вывода поиска, видимый для токенов

• задержку объединенного поиска по нескольким запросам

• задержку исследовательского поиска по нескольким запросам

• задержку извлечения

• задержку рендеринга при извлечении

• задержку пакетного извлечения

• задержку пакетного рендеринга при извлечении

Документация

• Обзор сайта документации

• Начало работы

• Развертывание

• Безопасность

• Справочник инструментов

• Конфигурации клиентов

• Сравнение

• Журнал изменений

• Документация SearXNG

Сборка и тестирование

uv sync --all-groups
uv run pytest -q
uv run python -m compileall src
uv run mkdocs build --strict

Поддержка зависимостей

Ручные проверки:

uv lock --upgrade --dry-run
uvx --from pip-audit pip-audit

Автоматизированные проверки:

• еженедельные PR от Dependabot для зависимостей uv и GitHub Actions

• еженедельный рабочий процесс Dependency Health для сканирования уязвимостей и пробных запусков обновлений