whw23/searxng-http-mcp

whw23/searxng-http-mcp

от whw23
MCP-сервер, оборачивающий SearXNG — приватную метапоисковую систему, собирающую результаты из 200+ поисковиков. Поддержка категорий, автодополнения, многопоточного сбора страниц. Самодостаточный Do...

A self-contained MCP server that wraps SearXNG — a free, privacy-respecting metasearch engine that aggregates results from 200+ search engines.


🚀 Quick Start

Server mode — deploy once, connect from any client:

docker run -d --name searxng-mcp --restart unless-stopped \
  -p YOUR_PORT:8888 --memory=512m --cpus=1 \
  ghcr.io/whw23/searxng-http-mcp:latest

Then connect your client to http://YOUR_HOST:YOUR_PORT/mcp/. To enable API key auth, see Authentication.

Local mode — no server needed, run directly in your client:

docker run --rm -i --memory=512m --cpus=1 ghcr.io/whw23/searxng-http-mcp:latest --stdio

Add this as a stdio MCP server in your client — see Client Configuration for details.

uvx mode — if you already have SearXNG running (install guide):

uvx searxng-http-mcp

Set SEARXNG_URL to point to your SearXNG instance (default: http://127.0.0.1:8080).

✨ Features

  • 🔍 200+ search engines — Google, Bing, DuckDuckGo, Brave, and more via SearXNG
  • 📂 30+ categories — news, images, videos, science, IT, and more
  • 📄 Multi-page fanout — up to 5 pages per call
  • 💡 Autocomplete suggestions — discover relevant search terms
  • 🗂 Engine discovery — query available engines grouped by category
  • 🎯 Token-efficient — results trimmed to essentials

Часто задаваемые вопросы

Инструменты были проиндексированы:
autocompleteтолько чтениеидемпотентныйвнешний мир

Получает подсказки поисковых запросов от SearXNG. Возвращает список подсказок автодополнения для заданного частичного запроса. Используйте это, чтобы найти релевантные поисковые термины перед выполнением полноценного поиска. Лучшие результаты получаются из 1-2 осмысленных ключевых слов (например, "python async"). Одиночные символы возвращают слишком общие подсказки; полные предложения не возвращают ничего. Совершает внешний API-вызов к настроенному бэкенду автодополнения (например, Bing, Google). Не подходит для полноценного веб-поиска (используйте search tool) или обнаружения движков (используйте engine_info tool).

Параметры
  • querystringобязательный

    Частичный строковый запрос для получения предложений. Лучшие результаты — с 1–2 ключевыми словами (например, 'python async'). Одиночные символы слишком общие; полные предложения ничего не возвращают.

engine_infoтолько чтениеидемпотентный

Получает доступные поисковые движки и категории из экземпляра SearXNG. Возвращает список включенных движков, сгруппированных по категориям. Используйте это, чтобы узнать, какие движки и категории доступны, перед вызовом search с фильтрами по конкретным движкам или категориям. Ответ кэшируется на 5 минут. Не выполняет веб-поиск — используйте для этого search tool.

Параметры

Без параметров.

searchтолько чтениеидемпотентныйвнешний мир

Ищет в интернете через метапоисковую систему SearXNG. Агрегирует результаты из 200+ поисковых систем (Google, Bing, DuckDuckGo, Brave и др.) с сохранением конфиденциальности. Возвращает результаты, ответы, подсказки, исправления и информационные блоки. Используйте 'categories', чтобы сузить поиск по типу контента. Используйте 'pages' для получения большего количества результатов. Не подходит для автодополнения (используйте инструмент autocomplete) или для поиска доступных движков/категорий (используйте инструмент engine_info). Результаты кэшируются на 60 секунд.

Параметры
  • categoriesstring

    Категории, разделённые запятыми, для фокусировки (например, 'general,news,science'). Предпочитай их 'движкам' для сужения результатов — категории автоматически задействуют несколько движков. Вызови engine_info, чтобы узнать доступные категории.

  • enginesstring

    Имена движков через запятую (например, 'google,arxiv,wikipedia'). Используйте только когда нужен конкретный источник; в остальных случаях предпочитайте 'categories'. Переопределяет выбор движков на основе категорий, если задано.

  • formatenum

    Уровень детализации результата: 'compact' возвращает только заголовок/URL/содержимое, 'full' включает движки/оценку/категорию/дату/миниатюры

  • languagestring

    Код языка для поиска (например, 'en', 'zh', 'ja', 'de'). Фильтрует результаты по указанному языку. Если не указано, поиск выполняется по всем языкам.

  • max_resultsinteger

    Максимальное количество результатов для возврата. Применяется после агрегации по страницам.

  • pagenointeger

    Начальный номер страницы. Используйте с 'pages' для постраничной разбивки.

  • pagesinteger

    Количество страниц для параллельной загрузки (многостраничный разбор). Большие значения дают больше результатов, но увеличивают задержку. Используйте 2–3 для полного исследования.

  • querystringобязательный

    Поисковый запрос

  • safesearchenum

    Уровень безопасного поиска: 0=выкл, 1=умеренный, 2=строгий

  • time_rangeenum | null

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

1.2.1основная
1.2.0
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.0

Выберите клиент, чтобы установить whw23/searxng-http-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"whw23-searxng-http-mcp-eal2gwhb5w\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"searxng-http-mcp\"],\"env\":{\"SEARXNG_URL\":\"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add whw23-searxng-http-mcp-eal2gwhb5w --env SEARXNG_URL=http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT -- uvx searxng-http-mcp

Либо через JSON-конфиг:

claude mcp add-json whw23-searxng-http-mcp-eal2gwhb5w "{\"command\":\"uvx\",\"args\":[\"searxng-http-mcp\"],\"env\":{\"SEARXNG_URL\":\"http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add whw23-searxng-http-mcp-eal2gwhb5w --env SEARXNG_URL=http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT -- uvx searxng-http-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.whw23-searxng-http-mcp-eal2gwhb5w]
command = "uvx"
args = ["searxng-http-mcp"]

[mcp_servers.whw23-searxng-http-mcp-eal2gwhb5w.env]
SEARXNG_URL = "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите whw23/searxng-http-mcp, а в поле команды запуска — строку ниже:
uvx searxng-http-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например whw23-searxng-http-mcp-eal2gwhb5w.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: whw23-searxng-http-mcp-eal2gwhb5w
    command: uvx
    args:
      - "searxng-http-mcp"
    env:
      SEARXNG_URL: http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "whw23-searxng-http-mcp-eal2gwhb5w": {
      "command": "uvx",
      "args": [
        "searxng-http-mcp"
      ],
      "env": {
        "SEARXNG_URL": "http://YOUR_SEARXNG_HOST:YOUR_SEARXNG_PORT"
      }
    }
  }
}

Похожие MCP-сервера

SecretiveShell/MCP-searxng

SecretiveShell/MCP-searxng

от secretiveshell

MCP инструмент для подключения агентов к поиску через searXNG. Выполняет запросы к метапоиску, собирает выдачу из разных источников. Идеально, когда ИИ-агенту нужны свежие данные из интернета.

Python⭐ 131
HughesCuit/heventure-search-mcp

HughesCuit/heventure-search-mcp

от hughescuit

Бесплатный MCP сервер для веб-поиска без API ключей. Мгновенный запуск, поддержка DuckDuckGo, Bing и Google. Полезен разработчикам AI ассистентов. Опционально доступны платные поисковики для лучших...

Python⭐ 10
Ihor-Sokoliuk/MCP-SearXNG

Ihor-Sokoliuk/MCP-SearXNG

от ihor-sokoliuk

MCP сервер для приватного веб-поиска, подключающий любой SearXNG к AI-ассистентам. Поддерживает поиск с пагинацией, чтение URL, кеширование, фильтры времени и языка — всё без API-ключей и с сохране...

TypeScript⭐ 1317
overtlids/mcp-searxng-enhanced

overtlids/mcp-searxng-enhanced

от overtlids

MCP-сервер для веб-поиска с поддержкой категорий (изображения, видео, файлы) и извлечения контента сайтов с цитированием. Включает чтение PDF, кэширование и управление временными зонами. Полезен разработчикам, интегрирующим SearXNG в ассистентов и инструменты.

Python⭐ 55
Exa MCP Server

Exa MCP Server

официальный

от exa-labs

Exa ищет по интернету и коду, извлекает чистый текст страниц и собирает данные о компаниях. Работает по API-ключу, хостить сервер не нужно.

TypeScript⭐ 5148
AceDataCloud/MCPSerp

AceDataCloud/MCPSerp

от acedatacloud

MCP-сервер для поиска в Google через SERP API. Выдаёт структурированные результаты: веб-страницы, изображения, новости, видео. Работает с Claude, VS Code и любыми MCP-клиентами. Поддерживает фильтр...

Python⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин