SearXNG MCP Server
MCP-сервер для приватного веб-поиска через ваш инстанс SearXNG: поиск с пагинацией и фильтрами, чтение страниц и PDF
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Сервер ходит в сеть и читает содержимое страниц и PDF
- Результаты поиска зависят от вашего инстанса SearXNG
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/searxng-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'SEARXNG_URL=<значение SEARXNG_URL>' searxng -- npx -y mcp-searxngИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"searxng","type":"stdio","command":"npx","args":["-y","mcp-searxng"],"env":{"SEARXNG_URL":"<значение SEARXNG_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"searxng": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add searxng --env 'SEARXNG_URL=<значение SEARXNG_URL>' -- npx -y mcp-searxngИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.searxng]
command = "npx"
args = ["-y", "mcp-searxng"]
env = { SEARXNG_URL = "<значение SEARXNG_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"searxng": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-searxng"
],
"environment": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"mcp-searxng"
],
"env": {
"SEARXNG_URL": "<значение SEARXNG_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
SEARXNG_URLобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь MCP-сервер в конфиг клиента: команда npx, аргументы -y mcp-searxng, переменная окружения SEARXNG_URL с адресом твоего инстанса SearXNG.
Другие способы из описания автора
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": ["-y", "mcp-searxng"],
"env": { "SEARXNG_URL": "https://search.example.com" }
}
}
}Замените адрес на URL вашего инстанса SearXNG. Нужен Node.js 22 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту веб-поиск через инстанс SearXNG, которым управляете вы или которому доверяете. Он умеет искать с пагинацией, фильтрами и прямыми ответами, отдавать результат текстом или JSON. Кроме поиска, сервер читает HTML и структурированный текст страниц, извлекает ограниченный текст из PDF и показывает заголовки или выбранные секции. Работает по локальному stdio или по Streamable HTTP, с опциональной защитой через статический токен или OAuth.
Для кого. Для разработчиков и аналитиков, которым нужен приватный веб-поиск для агента без привязки к коммерческому API.
Подходит, если
- Нужен веб-поиск для агента через свой инстанс SearXNG
- Нужно читать страницы и извлекать текст из PDF по ссылке
- Важна приватность и контроль над поисковым бэкендом
Не подходит, если
- Нет своего или доверенного инстанса SearXNG и нет желания его поднимать
- Нужен поиск в закрытых базах, а не в открытом вебе
Пример запроса к агенту
Найди свежие материалы по этой теме через веб-поиск и прочитай первые две страницыОграничения
Сервер сам поиск не выполняет: нужен работающий инстанс SearXNG, адрес задается через переменную окружения SEARXNG_URL. Для npx и npm нужен Node.js 22 или новее, для Docker образ требует проброса переменных. Извлечение текста из PDF ограничено по объему.
Как отключить. Удалите запись сервера из конфигурации MCP клиента и снесите пакет через npm uninstall -g mcp-searxng.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| SEARXNG_URL обязательная | Базовый адрес вашего инстанса SearXNG |
| MCP_HTTP_PORT | Порт для режима Streamable HTTP, для локального stdio не задается |
Проверка безопасности
- Сервер ходит в сеть и читает содержимое страниц и PDF
- Результаты поиска зависят от вашего инстанса SearXNG
Коротко о README
README описывает MCP-сервер, который дает агенту приватный веб-поиск через инстанс SearXNG. Есть поиск с пагинацией и фильтрами, чтение страниц и PDF, обнаружение возможностей инстанса и подсказки запросов. Устанавливается через npx, глобальный npm или Docker, адрес инстанса задается в SEARXNG_URL. Работает по stdio и Streamable HTTP. Лицензия MIT.
Частые вопросы
Нужен ли свой инстанс SearXNG?
Да, сервер обращается к инстансу SearXNG, которым вы управляете или которому доверяете. Его адрес задается в SEARXNG_URL.
Какие транспорты поддерживаются?
Локальный stdio для запуска рядом с клиентом и Streamable HTTP, с опциональной защитой токеном или OAuth.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы