Сервер MCP SearXNG
Реализация сервера MCP, интегрирующаяся с SearXNG, предоставляющая возможности метапоиска, ориентированные на конфиденциальность.
Функции
- Мета-поиск : объединяет результаты из нескольких поисковых систем.
- Конфиденциальность : без отслеживания и профилирования пользователей
- Несколько категорий : поддержка общих тем, новостей, науки, файлов, изображений, видео и многого другого.
- Поддержка языков : поиск на определенных языках или на всех языках
- Фильтрация по временному диапазону : фильтрация результатов по дню, неделе, месяцу или году.
- Безопасный поиск : три уровня фильтрации безопасного поиска
- Поддержка отката : несколько экземпляров SearXNG для надежности
Установка
Установка через Smithery
Чтобы автоматически установить SearXNG MCP Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @kevinwatt/mcp-server-searxng --client claude
Ручная установка
npm install -g @kevinwatt/mcp-server-searxng
Использование
Прямой запуск
- Нажмите «+ Добавить сервер MCP» в Dive Desktop.
- Скопируйте и вставьте эту конфигурацию:
{
"mcpServers": {
"searxng": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/mcp-server-searxng"
]
}
}
}
- Нажмите «Сохранить», чтобы установить сервер MCP.
Документация по инструменту
- веб-поиск
- Выполнять метапоиск в нескольких поисковых системах
- Входные данные:
query (строка): Условия поискаpage (номер, необязательно): Номер страницы (по умолчанию: 1)language (строка, необязательно): Код языка (например, «en», «all», по умолчанию: «all»)categories (массив, необязательно): Категории поиска (по умолчанию: ['general'])- Доступно: «общие», «новости», «наука», «файлы», «изображения», «видео», «музыка», «социальные сети», «it»
time_range (строка, необязательно): Фильтр времени (день/неделя/месяц/год)safesearch (число, необязательно): Уровень безопасного поиска (0: Нет, 1: Умеренный, 2: Строгий, по умолчанию: 1)
Разработка
git clone https://github.com/kevinwatt/mcp-server-searxng.git
cd mcp-server-searxng
npm install
npm run build
npm start
Лицензия
Этот сервер MCP лицензирован по лицензии MIT. Подробности см. в файле LICENSE.
Предпосылки
Вам нужен запущенный локальный экземпляр SearXNG. Чтобы настроить его:
Запустите SearXNG с Docker
Быстрый старт
# Create config directory
mkdir -p searxng
# Create config file
tee searxng/settings.yml << EOF
use_default_settings: true
server:
bind_address: "0.0.0.0"
secret_key: "CHANGE_THIS_TO_SOMETHING_SECURE" # Generate a random key
port: 8080
search:
safe_search: 0
formats:
- html
- json
engines:
- name: google
engine: google
shortcut: g
- name: duckduckgo
engine: duckduckgo
shortcut: d
- name: bing
engine: bing
shortcut: b
server.limiter: false
EOF
# Start container
docker run -d \
--name searxng \
-p 8080:8080 \
-v "$(pwd)/searxng:/etc/searxng" \
searxng/searxng
Тестовая функция поиска
# Test JSON API with curl
curl -v 'http://localhost:8080/search?q=test&format=json'
# Or visit in browser
http://localhost:8080/search?q=test
Управление контейнерами
# Stop container
docker stop searxng
# Remove container
docker rm searxng
# View container logs
docker logs searxng
# Enable auto-start on boot
docker update --restart always searxng
Флаг --restart always гарантирует, что:
- Контейнер запускается автоматически при запуске демона Docker
- Контейнер автоматически перезапускается в случае сбоя
- Контейнер автоматически перезапускается, если он остановлен, если только он явно не остановлен пользователем.
Индивидуальная конфигурация
Отредактируйте searxng/settings.yml следующим образом:
- Изменить список поисковых систем
- Настройте параметры безопасности
- Настроить язык пользовательского интерфейса
- Изменить ограничения API
Подробные параметры конфигурации см. в документации SearXNG.
Переменные среды
SEARXNG_INSTANCES : список URL-адресов экземпляров SearXNG, разделенных запятыми. По умолчанию: http://localhost:8080SEARXNG_USER_AGENT : Пользовательский заголовок User-Agent для запросов. По умолчанию: MCP-SearXNG/1.0NODE_TLS_REJECT_UNAUTHORIZED : установите значение «0», чтобы обойти проверку SSL-сертификата (для разработки с самоподписанными сертификатами). Значение по умолчанию: не определено (проверка SSL включена)
Пример конфигурации со всеми опциями:
{
"mcpServers": {
"searxng": {
"name": "searxng",
"command": "npx",
"args": [
"-y",
"@kevinwatt/mcp-server-searxng"
],
"env": {
"SEARXNG_INSTANCES": "http://localhost:8080,https://searx.example.com",
"SEARXNG_USER_AGENT": "CustomBot/1.0",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}
⚠️ Предупреждение: отключение проверки SSL-сертификата не рекомендуется в производственных средах.