ihor-sokoliuk/mcp-searxng

Добавлена фоновая проверка работоспособности SearXNG при запуске и обновлены зависимости.

• Added: Появилась опциональная фоновая проверка доступности SearXNG при старте с помощью переменной SEARXNG_STARTUP_HEALTHCHECK.
• Added: Добавлена настройка таймаута проверки SEARXNG_HEALTHCHECK_TIMEOUT_MS, позволяющая задать лимит времени для каждого экземпляра.
• Fixed: Обновлены зависимости express-rate-limit, jose, node-html-parser, ESLint и плагин безопасности, а также зафиксирована версия адаптера @hono/node-server.
• Поведение запуска осталось прежним, если новая проверка явно не включена; требуется Node.js 22+.

Добавлена многостраничная параллельная выдача, обновлен MCP SDK до 2.4.0, улучшена диагностика HTTP-жизни.

• Added: Добавлен аргумент pages для одновременного получения до пяти страниц поиска с дедупликацией.
• Added: Внедрена диагностика HTTP-жизни: учёт таймаутов, отказов по лимиту ресурсов и принудительных остановок.
• Added: Обновлены ядро, сервер и клиент MCP SDK до версии 2.4.0, а также Node-адаптер до 2.1.2.
• Deprecated: Удалена поддержка упаковки Nix, устаревших артефактов тестов и неиспользуемого прокси-кода.

Добавлена настройка таймаута для сессий HTTP POST и улучшена обработка сигналов завершения работы.

• Added: Появилась опциональная переменная MCP_HTTP_SESSION_REQUEST_TIMEOUT_MS для управления таймаутом состоятельных HTTP POST-запросов.
• Added: Улучшена обработка сигналов SIGINT/SIGTERM: корректное завершение сессий с возвратом HTTP 503 и ограничением времени завершения.
• Added: Обновлены зависимости: Undici, unpdf, jose, node-html-parser, ESLint и TypeScript ESLint, а также образ Node LTS Alpine.
• Node.js >=22 остается поддерживаемой версией; импорт через JS/TS пакеты по-прежнему не поддерживается.

Добавлено управление конкурентностью HTTP-запросов, обновлены зависимости и устранена уязвимость в инструментах сборки.

• Added: Внедрено настраиваемое ограничение конкурентности для состоятельных HTTP-запросов с лимитами по умолчанию 16 POST и 4 GET на сессию.
• Added: При превышении лимитов возвращается HTTP 503 с заголовком Retry-After, при этом операция DELETE остается доступной.
• Fixed: Заменена уязвимая shell-зависимость в сборке на нативные Node-инструменты, что устранило цепочку уязвимостей.
• Added: Обновлены зависимости: Express до 5.3.0, Undici до 7.30.0, Zod до 4.6.7 и пакеты TypeScript ESLint до 8.71.2.
• Fixed: Исправлены E2E-тесты для compact-search, чтобы корректно обрабатывать диагностику ошибок движка и CAPTCHA.

Добавлено автоматическое завершение неактивных HTTP-сессий и улучшена обработка ошибок пустых поисковых запросов.

• Added: Добавлена опциональная настройка времени жизни неактивных сессий (MCP_HTTP_SESSION_IDLE_TTL_MS) для очистки legacy-подключений.
• Fixed: Улучшено различение сбоев движков и реальных пустых результатов поиска с корректной маркировкой ошибок в ответах.
• Added: В компактный JSON-ответ добавлено поле unresponsive_engines, а в текстовый вывод — заметки о сбоях.
• Обновлены зависимости и инструменты CI, включая TypeScript ESLint и Supertest; уязвимостей в зависимостях не обнаружено.

Релиз v2.4.0: защита учётных данных, лимиты сессий, таймауты инициализации и обновление базового образа Node.

• Added: Добавлена защита учётных данных от утечек в диагностике, кэше и ответах инструментов.
• Added: Введены переменные MCP_HTTP_MAX_SESSIONS и MCP_HTTP_INITIALIZE_TIMEOUT_MS для управления лимитами сессий и таймаутами инициализации.
• Fixed: Улучшена работа браузерного решателя: использование рендеринга, восстановление терминала и повторная проверка DNS.
• Added: Обновлён базовый образ Docker до Alpine с Node 24.21.0, минимальная поддерживаемая версия — Node 22.
• Deprecated: Отменено расписание независимых пересборок Docker-образа, теперь публикуются только версионные релизы.

Добавлена поддержка OAuth для MCP, устранены уязвимости обхода IPv6 и улучшена устойчивость парсинга метаданных.

• Added: Добавлен опциональный режим OAuth для MCP с проверкой токенов и обнаружением ресурсов.
• Fixed: Заблокирован доступ к приватным IPv4-адресам через инкапсуляцию в IPv6 и неглобальные IPv6-URL.
• Fixed: Исправлена обработка некорректных метаданных, предотвращающая искажение результатов поиска.
• Fixed: Обновлена уязвимая зависимость парсера запросов.
• Обновлены зависимости среды выполнения и CI-действия, требование Node.js 22+ сохранено.

Добавлен параметр result_detail для выбора формата ответа поиска: компактный (3 строки) или полный (с метаданными).

• Added: В searxng_web_search добавлен параметр result_detail с режимами compact и full.
• Added: Режим compact возвращает только заголовок, URL и описание, экономя токены.
• Added: Режим full сохраняет все метаданные SearXNG и исследовательские сигналы.
• Breaking: Парсеры, зависящие от метаданных, должны явно запрашивать result_detail=full.

Добавлена настройка формата ответа SearXNG и безсостоянный режим Streamable HTTP для серверных развертываний.

• Added: Появилась возможность задавать формат ответа SearXNG по умолчанию через переменную SEARXNG_DEFAULT_RESPONSE_FORMAT (text или json).
• Added: Реализован безсостоянный режим Streamable HTTP (MCP_HTTP_STATELESS=true) для изоляции запросов в серверных и горизонтально масштабируемых средах.
• Added: В безсостоянном режиме добавлены ограничения на количество одновременных запросов, время жизни запроса и усиленная проверка авторизации.
• Added: Из схемы инструмента удалена жестко заданная аннотация default: text, что позволяет клиентам корректно использовать операторские настройки по умолчанию.

Внедрено кэширование поисковых запросов, поддержка Basic Auth в URL для каждого инстанса SearXNG и настройка User-Agent, исправлены ошибки аутентификации.

• Added: Добавлено in-memory кэширование результатов поиска с настраиваемым TTL и лимитом записей.
• Added: Появилась возможность задавать учетные данные Basic Auth непосредственно в URL каждого инстанса SearXNG.
• Added: Введена переменная SEARCH_USER_AGENT для управления заголовком User-Agent в запросах к SearXNG.
• Fixed: Исправлено применение Basic Auth и пользовательских CA-сертификатов на всех эндпоинтах, включая /config и /autocompleter.
• Fixed: Улучшено сообщение об ошибке при превышении лимита размера контента в web_url_read.
• Added: В ресурсе config теперь скрываются учетные данные из URL, чтобы избежать утечки секретов.