Сервер MCP SearXNG

Реализация сервера MCP, интегрирующаяся с SearXNG, предоставляющая возможности метапоиска, ориентированные на конфиденциальность.

Функции

• Мета-поиск : объединяет результаты из нескольких поисковых систем.

• Конфиденциальность : без отслеживания и профилирования пользователей

• Несколько категорий : поддержка общих тем, новостей, науки, файлов, изображений, видео и многого другого.

• Поддержка языков : поиск на определенных языках или на всех языках

• Фильтрация по временному диапазону : фильтрация результатов по дню, неделе, месяцу или году.

• Безопасный поиск : три уровня фильтрации безопасного поиска

• Поддержка отката : несколько экземпляров SearXNG для надежности

Related MCP server: Wuxing Search MCP

Установка

Установка через 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-server-searxng

С Dive Desktop

1. Нажмите «+ Добавить сервер MCP» в Dive Desktop.

2. Скопируйте и вставьте эту конфигурацию:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-server-searxng"
      ]
    }
  }
}

3. Нажмите «Сохранить», чтобы установить сервер 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:8080

• SEARXNG_USER_AGENT : Пользовательский заголовок User-Agent для запросов. По умолчанию: MCP-SearXNG/1.0

• NODE_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-сертификата не рекомендуется в производственных средах.