Добавить сервер
Ihor-Sokoliuk/MCP-SearXNG
  1. Каталог MCP
  2. Ihor-Sokoliuk/MCP-SearXNG

Ihor-Sokoliuk/MCP-SearXNG

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

🔍 SearXNG MCP Server

Privacy-respecting web search for AI assistants — use an operator-controlled or trusted SearXNG instance with Claude, Cursor, and more.

GitHub Stars npm version npm downloads Docker Pulls License: MIT OpenSSF Scorecard OpenSSF Best Practices mcp-searxng MCP server GitHub MCP Registry

An MCP server that integrates the SearXNG API, giving AI assistants web search capabilities.

✨ Featured in the GitHub MCP Registry.

Quick Start

You need an existing SearXNG instance with JSON search enabled. This project connects an MCP client to SearXNG; it does not install SearXNG. Use an instance you operate or trust. Start with the self-hosted or public-instance guide if needed.

Choose how to connect:

Your setup Start here
Client starts the server locally Install Node.js 22 or later, then use the NPX example below or your client recipe.
Client starts a Docker container Use the Docker/STDIO recipe in Installation.
You have an independently running HTTP service Use your client's HTTP recipe with the full /mcp URL.
You need to operate an HTTP service Follow the HTTP server guide.

For clients using mcpServers JSON (such as Claude Desktop), add:

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

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

Обнаруживает возможности из всех доступных настроенных экземпляров SearXNG через /config, включая categories.common/available, engines.common/available, defaults, locales и plugins.

Параметры
  • categorystring

    Отфильтруйте категории и движки до одного имени категории.

  • includeDisabledboolean

    Включать имена отключенных движков, когда includeEngines равно true.

  • includeEnginesboolean

    Укажи в ответе названия активных движков.

  • refreshboolean

    Обойдите кэш процесса и получите свежие данные /config.

searxng_search_suggestionsтолько чтениевнешний мир

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

Параметры
  • languagestring

    Код языка для предложений (например, 'en', 'fr', 'de') или 'all'. По умолчанию: all.

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

    Частичный или полный запрос для автозаполнения.

searxng_web_searchтолько чтениевнешний мир

Выполняет поиск в интернете через SearXNG и возвращает список результатов, каждый из которых содержит заголовок, URL и фрагмент содержимого. КРИТИЧЕСКИ ВАЖНО: имя обязательного параметра должно быть точно query (не prompt, q или любое другое имя). Вызывает внешний экземпляр SearXNG; доступность зависит от конфигурации SEARXNG_URL. Используйте pageno для постраничной разбивки результатов; комбинируйте time_range и language, чтобы сузить область поиска. Когда engines и time_range указаны вместе, каждая выбранная поисковая система должна явно поддерживать временные диапазоны через SearXNG /config; в противном случае запрос отклоняется до выполнения поиска. Чтобы прочитать полный текст URL результата, дополнительно вызовите web_url_read.

Параметры
  • categoriesstring

    Категории SearXNG, разделённые запятыми. Возможности из живого /config агрегируются по доступным инстансам; для стабильных результатов на нескольких инстансах предпочитайте категории из searxng_instance_info categories.common. Значения в categories.available приводятся по мере возможности, и их может поддерживать только часть инстансов. Известные значения нормализуются без учёта регистра; неизвестные передаются как есть, с обрезкой пробелов, чтобы SearXNG мог их проигнорировать или обработать. Если /config недоступен, значения передаются без изменений с предупреждением. Если параметр опущен, каждый инстанс использует значение по умолчанию со своей стороны сервера.

  • enginesstring

    Имена движков SearXNG, разделённые запятыми, для запроса (например, 'google,bing,ddg'). Возможности /config агрегируются по доступным экземплярам; предпочтительно использовать engines.common.enabled из searxng_instance_info для согласованных результатов на нескольких экземплярах. Значения в engines.available.enabled являются наилучшими усилиями и могут учитываться только некоторыми экземплярами. Известные значения нормализуются без учёта регистра; неизвестные значения передаются как есть, чтобы SearXNG мог их проигнорировать или учесть. Если /config недоступен, значения передаются без изменений с предупреждением. Если параметр опущен, каждый экземпляр использует своё значение по умолчанию на стороне сервера.

  • languagestring

    Код языка для результатов поиска (например, 'en', 'fr', 'de'). По умолчанию зависит от инстанса.

  • min_scorenumber

    Минимальный порог оценки релевантности от 0.0 до 1.0. Результаты ниже этой оценки отфильтровываются.

  • num_resultsnumber

    Максимальное количество результатов для возврата (1-20). Ограничение оператора SEARXNG_MAX_RESULTS действует как потолок.

  • pagenointeger

    Номер страницы поиска (начинается с 1)

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

    Строка поискового запроса. Это обязательное имя параметра — используйте именно query, а не prompt или q.

  • response_formatenum

    Формат ответа: форматированный текст для агентов или сырой JSON для программных клиентов. Если параметр опущен, применяется SEARXNG_DEFAULT_RESPONSE_FORMAT; если не задан или недействителен, используется текст. Явно указанный response_format всегда имеет приоритет.

  • result_detailenum

    Детализация результатов: режим full сохраняет метаданные SearXNG и поисковые сигналы; режим compact возвращает только поля title, URL и content-snippet для каждого результата (ключи JSON: title, url, content). Если параметр не указан, используется режим full.

  • safesearchenum

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

  • time_rangeenum

    Временной диапазон поиска (день, неделя, месяц, год). При явно указанных движках все выбранные движки должны подтвердить time_range_support=true через /config.

web_url_readтолько чтениевнешний мир

Получает URL и возвращает читаемый контент в формате markdown. Учитывает тип содержимого: HTML преобразуется в markdown; JSON выводится в удобном форматировании; plain text, YAML, TOML и XML возвращаются как блоки читаемого текста. Бинарные файлы, медиа, архивы, PDF и потоки octet-stream намеренно отклоняются — вместо них не возвращаются сырые байты. Три режима: (1) Полный контент — не указывай параметры фильтрации; используй startChar/maxLength для пагинации по большим страницам. (2) Извлечение раздела — укажи section, чтобы получить содержимое под конкретным заголовком. (3) Только заголовки — установи readHeadings: true для списка всех заголовков (взаимоисключающий режим с другими параметрами фильтрации). Возвращает строку с ошибкой, если URL недоступен или контент не извлекается. Используй после searxng_web_search, чтобы прочитать полное содержимое отдельных ссылок из результатов.

Параметры
  • maxLengthnumber

    Максимальное количество символов для возврата

  • paragraphRangestring

    Возвращай конкретные диапазоны абзацев (например, '1-5', '3', '10-')

  • readHeadingsboolean

    Возвращай только список заголовков вместо полного содержимого

  • sectionstring

    Извлекает содержимое под конкретным заголовком (ищет текст заголовка)

  • startCharnumber

    Указывает начальную позицию символа для извлечения содержимого (по умолчанию: 0)

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

    URL

2.6.0основная
2.5.1
2.5.0
2.4.0
2.3.0
2.2.0
2.1.0
2.0.0
1.16.0
1.15.0
1.14.1
1.14.0
1.13.0
1.12.1
1.12.0
1.11.1
1.11.0
1.10.1
1.10.0
1.9.0
1.8.0
1.7.2
1.7.1
1.7.0
1.6.0
1.5.0
1.4.0
1.3.4
1.3.3
1.3.2
1.3.1
1.3.0
1.2.1
1.2.0
1.1.1
1.1.0
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
0.10.5
0.10.4
0.10.3
0.10.2
0.10.1
0.10.0
0.9.2
0.9.1
0.9.0
0.8.0
0.7.12
0.7.11
0.7.10
0.7.9
0.7.8
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.5
0.6.4
0.6.3
0.6.2
0.6.1
0.6.0
0.5.2
0.5.1
0.5.0
0.4.6
0.4.5
0.4.3
0.4.2
0.4.1
0.4.0
0.3.6
0.3.1
0.3.0
0.2.2
0.2.1
0.2.0

Выберите клиент, чтобы установить Ihor-Sokoliuk/MCP-SearXNG:

Любой клиент

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

{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
VS Code

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

{
  "servers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"ihor-sokoliuk-mcp-searxng-x1wq8eu9sy\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-searxng\"],\"env\":{\"SEARXNG_URL\":\"YOUR_SEARXNG_INSTANCE_URL\"}}"
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": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
Claude CodeClaude Code

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

claude mcp add ihor-sokoliuk-mcp-searxng-x1wq8eu9sy --env SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL -- npx -y mcp-searxng

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

claude mcp add-json ihor-sokoliuk-mcp-searxng-x1wq8eu9sy "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-searxng\"],\"env\":{\"SEARXNG_URL\":\"YOUR_SEARXNG_INSTANCE_URL\"}}"
CodexCodex

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

codex mcp add ihor-sokoliuk-mcp-searxng-x1wq8eu9sy --env SEARXNG_URL=YOUR_SEARXNG_INSTANCE_URL -- npx -y mcp-searxng

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

[mcp_servers.ihor-sokoliuk-mcp-searxng-x1wq8eu9sy]
command = "npx"
args = ["-y", "mcp-searxng"]

[mcp_servers.ihor-sokoliuk-mcp-searxng-x1wq8eu9sy.env]
SEARXNG_URL = "YOUR_SEARXNG_INSTANCE_URL"
PerplexityPerplexity

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

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

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: ihor-sokoliuk-mcp-searxng-x1wq8eu9sy
    command: npx
    args:
      - "-y"
      - "mcp-searxng"
    env:
      SEARXNG_URL: YOUR_SEARXNG_INSTANCE_URL
Zed

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

{
  "context_servers": {
    "ihor-sokoliuk-mcp-searxng-x1wq8eu9sy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

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

overtlids/mcp-searxng-enhanced

overtlids/mcp-searxng-enhanced

от overtlids

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

Python⭐ 55
AceDataCloud/MCPSerp

AceDataCloud/MCPSerp

от acedatacloud

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

Python⭐ 1
whw23/searxng-http-mcp

whw23/searxng-http-mcp

от whw23

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

Python⭐ 12
HughesCuit/heventure-search-mcp

HughesCuit/heventure-search-mcp

от hughescuit

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

Python⭐ 10
SecretiveShell/MCP-searxng

SecretiveShell/MCP-searxng

от secretiveshell

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

Python⭐ 131
wd041216-bit/free-web-search-ultimate

wd041216-bit/free-web-search-ultimate

от wd041216-bit

Zero-API-Key Web Search - MCP-сервер для AI-агентов: веб-поиск, извлечение контекста, проверка утверждений с взвешенной оценкой доказательств. Бесплатно без API-ключа, поддерживает DuckDuckGo, Sear...

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

Лука Никитин