SearXNG MCP: веб-поиск без ключей API в Claude Code и Cursor

ihor-sokoliuk/mcp-searxng· Проверено 12.11.2026· 1,4 тыс.на GitHub

Даёт агенту веб-поиск через метапоисковик SearXNG без платных ключей: своя или публичная инстанция, выдача с фильтрами и чтение найденных страниц в Markdown.

3 реализации:

Поиск с пагинацией и фильтрами, подсказки запросов, чтение страниц и PDF; несколько реплик SearXNG, кэш, прокси, работа по stdio и Streamable HTTP.

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

Что сделать до подключения

Node.js 22 или новее; вместо него можно Docker-образ isokoliuk/mcp-searxng:latest

Своя или доверенная инстанция SearXNG с включённым JSON-выводом: сам сервер SearXNG не ставит

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SEARXNG_URL=<адрес вашей SearXNG>' --transport stdio searxng \
  -- npx -y mcp-searxng

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

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

[mcp_servers.searxng.env]
SEARXNG_URL = "<адрес вашей SearXNG>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "searxng": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "searxng": {
        "type": "local",
        "command": ["npx", "-y", "mcp-searxng"],
        "environment": {
          "SEARXNG_URL": "<адрес вашей SearXNG>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "<адрес вашей SearXNG>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

searxng_web_searchищет в вебе с фильтрами

searxng_search_suggestionsподсказывает запросы

searxng_instance_infoпоказывает категории и движки

web_url_readчитает страницу в Markdown

Для публичных инстанций без JSON: разбирает HTML-выдачу, берёт до трёх серверов из списка, остальные служат запасными.

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

Что сделать до подключения

Node.js; npm install mcp-searxng-public

Список публичных инстанций SearXNG через точку с запятой

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SEARXNG_BASE_URL=<адреса публичных SearXNG через ;>' --env DEFAULT_LANGUAGE=ru --transport stdio mcp-searxng-public \
  -- npx mcp-searxng-public

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-searxng-public]
command = "npx"
args = ["mcp-searxng-public"]

[mcp_servers.mcp-searxng-public.env]
SEARXNG_BASE_URL = "<адреса публичных SearXNG через ;>"
DEFAULT_LANGUAGE = "ru"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-searxng-public": {
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-searxng-public": {
      "type": "stdio",
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-searxng-public": {
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-searxng-public": {
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-searxng-public": {
        "type": "local",
        "command": ["npx", "mcp-searxng-public"],
        "environment": {
          "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
          "DEFAULT_LANGUAGE": "ru"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-searxng-public": {
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-searxng-public": {
      "command": "npx",
      "args": ["mcp-searxng-public"],
      "env": {
        "SEARXNG_BASE_URL": "<адреса публичных SearXNG через ;>",
        "DEFAULT_LANGUAGE": "ru"
      }
    }
  }
}

Инструменты сервера

searchищет на публичных SearXNG

Минимальный сервер на Python с одним инструментом поиска; по умолчанию ищет через SearXNG на http://localhost:8080.

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

Что сделать до подключения

uv с командой uvx

Запущенная SearXNG; без SEARXNG_URL сервер обращается к http://localhost:8080

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env SEARXNG_URL=http://localhost:8080 --transport stdio mcp-searxng \
  -- uvx mcp-searxng

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

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

[mcp_servers.mcp-searxng.env]
SEARXNG_URL = "http://localhost:8080"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-searxng": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-searxng": {
        "type": "local",
        "command": ["uvx", "mcp-searxng"],
        "environment": {
          "SEARXNG_URL": "http://localhost:8080"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-searxng": {
      "command": "uvx",
      "args": ["mcp-searxng"],
      "env": {
        "SEARXNG_URL": "http://localhost:8080"
      }
    }
  }
}

Инструменты сервера

searchищет в вебе через SearXNG

Что попросить агента

«Найди документацию SearXNG»SearXNG MCP Server вызовет searxng_web_search с запросом SearXNG

«Найди свежие новости о <тема> за последний месяц»mcp-searxng-public вызовет search с time_range month

«Прочитай <адрес страницы> и перескажи раздел об установке»SearXNG MCP Server вызовет web_url_read и выберет нужный раздел

«Какие движки и категории есть у нашей SearXNG?»Агент вызовет searxng_instance_info

Для каких задач

Искать в вебе без ключа API платного поисковика

Листать выдачу по страницам и фильтровать по категориям и движкам

Прочитать найденную страницу или PDF и вынуть нужный раздел

Подобрать формулировку запроса по подсказкам SearXNG

Искать по публичным инстанциям SearXNG, если своей нет

Ограничения

SearXNG ставится отдельно: серверы только подключают к ней агента

SearXNG MCP Server и MCP-searxng ждут JSON-вывод, а большинство публичных инстанций его не отдают; для них нужен mcp-searxng-public или SEARXNG_HTML_FALLBACK=true

Публичная инстанция видит ваши запросы и может их записывать: приватность зависит от того, чья это SearXNG

Разбор HTML у mcp-searxng-public и в режиме HTML fallback идёт по возможности, метаданных в выдаче меньше

Если не работает

SearXNG отвечает 403 Forbidden

Выключен JSON-вывод или запрос режет контроль доступа. Рабочая страница в браузере не значит, что работает JSON API: проверьте его напрямую.

JSON на инстанции не включить

Задайте SEARXNG_HTML_FALLBACK=true: сервер повторит запрос как HTML; разбор приблизительный, метаданных меньше.

Инструменты видны, а поиск падает

Проблема в связи с SearXNG: проверьте SEARXNG_URL. Он указывает на саму SearXNG, не на MCP-эндпоинт.

MCP-searxng в Claude Desktop не перезапускается

Перед повторным запуском завершите старый процесс сервера в диспетчере задач.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
SearXNG MCP Server	ihor-sokoliuk	1,4 тыс.	локально	не нужен	4	11 ноября 2026
mcp-searxng-public	pwilkin	57	локально	не нужен	1	23 мая 2026
MCP-searxng (Python)	SecretiveShell	132	локально	не нужен	1	29 мая 2026

Частые вопросы

Зачем SearXNG, если есть Brave Search или Exa?

Платный ключ поисковика не нужен, и SearXNG можно держать у себя. Взамен её придётся поднять или найти доверенную публичную инстанцию.

Где взять SearXNG?

Поднимите свою по гайду self-hosted в репозитории ihor-sokoliuk/mcp-searxng или возьмите публичную. Для своей включите в настройках JSON-формат выдачи.

У SearXNG MCP Server и MCP-searxng одинаковое имя mcp-searxng?

Да, но это разные пакеты: npx -y mcp-searxng запускает сервер ihor-sokoliuk из npm, uvx mcp-searxng — сервер SecretiveShell на Python.

Можно ли искать на русском?

У mcp-searxng-public язык задаёт DEFAULT_LANGUAGE или параметр language в запросе, например ru. Без них параметр языка в SearXNG не передаётся.

Как подключить SearXNG MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: там команда для npx -y mcp-searxng с переменной SEARXNG_URL. Подставьте адрес своей SearXNG.

Как запустить SearXNG MCP в Docker?

Возьмите образ isokoliuk/mcp-searxng:latest: docker run -i --rm -e SEARXNG_URL isokoliuk/mcp-searxng:latest, а саму переменную задайте в env клиента.

Работает ли сервер из России?

Серверы работают на вашем компьютере; поиск идёт через выбранную инстанцию SearXNG, а она уже опрашивает поисковики. Со своей инстанцией внешних аккаунтов не нужно.

SearXNG MCP: веб-поиск без ключей API в Claude Code и Cursor

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы