SearXNG HTTP MCP

SearXNG HTTP MCP

whw23MIT
4 звёзд
SearXNG HTTP MCP решает типовую задачу: AI-модели работают с устаревшими данными, а им нужны актуальные факты, новости или документация. Сервер даёт им свежие данные из интернета. В основе лежит SearXNG — популярная метапоисковая система с открытым кодом. Она не хранит индекс, а собирает результаты из сотен поисковиков. Это даёт два преимущества. Первое — полнота охвата. Вы получаете ответы из Google, Bing, DuckDuckGo, специализированных сайтов и научных баз. Второе — приватность. Запросы не отслеживаются. Поисковые системы видят трафик от SearXNG, а не от конкретного пользователя. Для разработчиков это готовая инфраструктура. Сервер упакован в Docker-образ. Внутри одного контейнера сразу два компонента: MCP-сервер для общения с AI и сам SearXNG. Запускается командой docker run. Никаких внешних баз данных, сложных конфигов или регистрации в сторонних API.
DesignCloud-devopsDocker
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • Разработчикwhw23
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdiostreamable-http

Описание

Возможности

  • Выполняет поиск по сотням поисковых движков, включая Google, Bing, DuckDuckGo, Yahoo, Wikipedia.
  • Поддерживает категории: общие результаты, новости, изображения, видео, научные работы, файлы, IT.
  • Извлекает полный HTML-текст с указанной веб-страницы и передаёт его ассистенту для анализа.
  • Фильтрует результаты по региону и языку, что важно для локально релевантного поиска.
  • Работает в двух транспортных протоколах: stdio (простой запуск из CLI) и streamable-http (для серверной интеграции).
  • Запускается одной командой Docker без ручной установки Python и зависимостей.
  • Устанавливается как Python-пакет через pip для встраивания в собственные пайплайны.
  • Гибко настраивается через переменные окружения: адрес SearXNG, таймауты, настройки кэширования.
  • Полностью совместим с любыми MCP-клиентами: Claude Desktop, VS Code, Cursor.
  • Исходный код открыт под лицензией MIT.

Как подключить

Через Docker

  1. Загрузите образ: docker pull ghcr.io/whw23/searxng-http-mcp:latest
  2. Добавьте конфигурацию в файл MCP-клиента. Для Claude Desktop: {"mcpServers":{"searxng":{"command":"docker","args":["run","-i","--rm","ghcr.io/whw23/searxng-http-mcp:latest"]}}}
  3. Если используете свой экземпляр SearXNG, передайте его адрес: {"mcpServers":{"searxng":{"command":"docker","args":["run","-i","--rm","-e","SEARXNG_HTTP_MCP_SEARXNG_BASE_URL=http://ваш-сервер:8888","ghcr.io/whw23/searxng-http-mcp:latest"]}}}
  4. Перезапустите клиент (Claude Desktop, Cursor, VS Code).

Через Python

  1. Установите пакет: pip install searxng-http-mcp
  2. Запустите сервер: searxng-http-mcp
  3. Настройте клиент: {"mcpServers":{"searxng":{"command":"uv","args":["run","searxng-http-mcp"]}}}

Примеры запросов

  • «Покажи топ-10 новостей про искусственный интеллект за последнюю неделю на русском языке.»
  • «Сравни цены на iPhone 16 Pro в трёх разных интернет-магазинах, выведи в виде таблицы.»
  • «Найди документацию по FastAPI на официальном сайте и выпиши, как подключить CORS.»
  • «Найди изображения высокого разрешения по запросу "ночной город" без лицензионных ограничений.»
  • «Извлеки текст со страницы с ценами https://example.com/pricing и структурируй данные.»

Технические детали

  • Язык разработки: Python 3.14+
  • Транспортные протоколы: stdio, streamable-http
  • Лицензия: MIT
  • Деплой: Docker-образ (рекомендуется) или PyPI-пакет
  • Совместимость: Claude Desktop, Continue.dev, Cline, VS Code, Cursor, любое MCP SDK
  • Архитектура: самодостаточный контейнер (MCP-сервер + SearXNG)
  • Конфигурация: переменные окружения
  • Репозиторий: github.com/whw23/searxng_http_mcp

Поделиться