Wuxing Search MCP

Что такое Wuxing Search MCP?

Wuxing Search MCP — это мощный сервер для неограниченного поиска, построенный на базе SearXNG. Он легко интегрируется с Claude Code через протокол Model Context Protocol (MCP), предоставляя бесплатные и неограниченные возможности поиска за счет агрегации результатов более чем 100 поисковых систем.

Почему стоит выбрать Wuxing Search?

Традиционные API для поиска имеют ограничения:

• ❌ Ограничения по частоте запросов и квоты

• ❌ Высокая стоимость API

• ❌ Результаты из одного источника

Wuxing Search решает все эти проблемы:

• ✅ Полностью бесплатно — собственный экземпляр SearXNG, никаких затрат на API

• ✅ Неограниченный поиск — отключены лимиты по частоте запросов, поддержка высокочастотного поиска

• ✅ Агрегация множества источников — Google, Bing, DuckDuckGo, Brave и более 100 других движков

• ✅ Конфиденциальность — без отслеживания и логирования

• ✅ Интеграция с MCP — идеальная совместимость с рабочим процессом Claude Code

Related MCP server: SearXNG MCP Server

Описание архитектуры

┌─────────────┐      ┌──────────────┐      ┌─────────────┐      ┌─────────────┐
│  你        │ ───▶ │ Claude Code │ ───▶ │ Wuxing      │ ───▶ │  SearXNG    │
│  (用户)    │      │  (MCP 客户端) │      │ Search MCP   │      │ (Docker)    │
└─────────────┘      └──────────────┘      │ (Node.js)   │      │ (Python)    │
                                            └──────────────┘      └─────────────┘
                                                    │
                                                    ▼
                                            ┌───────────────────────────┐
                                            │   搜索引擎聚合 (13+)      │
                                            │   通用: Google, Bing...   │
                                            │   代码: GitHub, HuggingFace│
                                            │   问答: StackOverflow     │
                                            │   包: npm, PyPI           │
                                            │   学术: arXiv             │
                                            │   社区: HN, Reddit        │
                                            │   以及 100+ 更多...       │
                                            └───────────────────────────┘

Функциональные особенности

✨ Текущие возможности

• 🔍 Неограниченный веб-поиск

  • Отсутствие лимитов API и квот

  • Поддержка высокочастотного поиска

  • Настраиваемое количество результатов (1-100)

• 🌐 Агрегация множества источников

  • Общие: Google, Bing, DuckDuckGo, Baidu

  • Код: GitHub, Hugging Face, GitLab

  • Вопросы и ответы: Stack Overflow

  • Пакеты: npm, PyPI, crates.io, Docker Hub

  • Академические: arXiv, Google Scholar, Semantic Scholar, PubMed

  • Сообщества: HackerNews, Reddit, Mastodon

  • Документация: MDN

  • Новости: Google News

  • Поддержка более 100 поисковых систем

• 📊 Расширенные параметры поиска

  • Фильтрация по времени (день, неделя, месяц, год)

  • Фильтрация по категориям (общие, изображения, видео, новости, IT, наука, файлы, социальные сети)

  • Фильтрация по языку

  • Уровни безопасного поиска

• 🔌 Интеграция с MCP

  • Бесшовная интеграция с Claude Code

  • Связь через stdio (MCP не требует сетевых портов)

  • Протокол JSON-RPC 2.0

• 🐳 Простая установка

  • Развертывание SearXNG на базе Docker

  • Установка в один клик

  • Кроссплатформенная поддержка (Windows, macOS, Linux)

• 🔒 Приоритет конфиденциальности

  • Без отслеживания и логирования

  • Самостоятельный хостинг, данные не покидают ваш компьютер

  • Анонимный поиск через SearXNG

Быстрый старт

4 простых шага для начала работы:

Предварительные требования

• Docker (обязательно): скачать

• Node.js 18+ (обязательно): скачать

1. Клонирование проекта

git clone https://github.com/MaesHughes/wuxing-search-mcp.git
cd wuxing-search-mcp

2. Установка зависимостей

npm install

3. Запуск SearXNG

Вариант А: Использование команды Docker (рекомендуется)

docker run -d \
  --name wuxing-searxng \
  --restart unless-stopped \
  -p 18080:8080 \
  -v "$(pwd)/searxng/config:/etc/searxng/" \
  -v "$(pwd)/searxng/data:/var/cache/searxng/" \
  searxng/searxng:latest

Вариант Б: Использование Docker Compose

docker-compose up -d

4. Настройка Claude Code

Найдите файл конфигурации Claude Code:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS / Linux:

~/.config/Claude/claude_desktop_config.json

Шаг 1: Получение пути к проекту

Выполните следующую команду в директории проекта, чтобы получить абсолютный путь:

Windows (PowerShell):

Resolve-Path src\index.js

Windows (Git Bash / Bash):

pwd -W && echo "/src/index.js"
# 或手动拼接：$(pwd -W)/src/index.js

macOS / Linux:

pwd && echo "/src/index.js"
# 或手动拼接：$(pwd)/src/index.js

Шаг 2: Добавление конфигурации

Добавьте следующую конфигурацию в файл, ⚠️ обязательно заменив YOUR_FULL_PATH_HERE на фактический путь, полученный на предыдущем шаге:

Пример конфигурации для Windows

{
  "mcpServers": {
    "wuxing-search": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "D:\\\\path\\\\to\\\\wuxing-search-mcp\\\\src\\\\index.js"
      ],
      "env": {
        "SEARXNG_URL": "http://localhost:18080",
        "MAX_RESULTS": "20",
        "TIMEOUT": "30000"
      }
    }
  }
}

Пример конфигурации для macOS / Linux

{
  "mcpServers": {
    "wuxing-search": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/home/username/wuxing-search-mcp/src/index.js"
      ],
      "env": {
        "SEARXNG_URL": "http://localhost:18080",
        "MAX_RESULTS": "20",
        "TIMEOUT": "30000"
      }
    }
  }
}

Примечания по конфигурации:

⚠️ Важное примечание:

• Обратные косые черты в путях Windows должны быть экранированы двойными \\ (требование формата JSON)

• Либо используйте прямые косые черты / (Windows также их поддерживает)

• Путь должен быть абсолютным, относительные пути не работают

• После изменения конфигурации необходимо полностью перезапустить Claude Code

5. Перезапуск Claude Code

Полностью закройте и снова откройте Claude Code.

Использование

Базовый поиск

Введите прямо в Claude Code:

请搜索最新的 AI 编程工具

Параметры расширенного поиска

Вы также можете указать параметры:

请搜索最近一周的 React 教程，返回 10 条结果

Доступные инструменты

1. web_search

Выполняет веб-поиск и возвращает результаты.

Опции категорий:

• general - общий поиск

• images - поиск изображений

• videos - поиск видео

• news - поиск новостей

• it - IT-технологии

• science - наука

• files - файлы

• social - социальные сети

Опции временного диапазона:

• day - последние 24 часа

• week - последняя неделя

• month - последний месяц

• year - последний год

• none - без фильтрации по времени

2. get_server_info

Получение информации о состоянии поискового сервера. Без параметров.

Примеры использования

Пример 1: Поиск проектов с открытым исходным кодом

请搜索 GitHub 上热门的 AI agent 项目

Пример 2: Поиск технических вопросов

在 Stack Overflow 上搜索 MCP 连接错误的解决方案

Пример 3: Поиск научных статей

请搜索 arXiv 上关于多智能体协作的最新论文

Пример 4: Поиск библиотек Python

在 PyPI 上搜索 LangChain agents 相关的包

Пример 5: Поиск обсуждений разработчиков

请搜索 HackerNews 上关于 AI 编程的讨论

Пример 6: Проверка состояния сервера

查询搜索服务器状态

Команды управления

Команды NPM

# 查看 SearXNG 状态
npm run status:searxng

# 查看 SearXNG 日志
npm run logs:searxng

# 重启 SearXNG
npm run restart:searxng

# 停止 SearXNG
npm run stop:searxng

# 启动 SearXNG
npm run start:searxng

# 测试搜索服务
npm run test:searxng

Команды Docker

# 查看容器状态
docker ps | grep wuxing-searxng

# 查看实时日志
docker logs -f wuxing-searxng

# 重启服务
docker restart wuxing-searxng

# 停止服务
docker stop wuxing-searxng

# 启动服务
docker start wuxing-searxng

# 删除并重建
docker stop wuxing-searxng && docker rm wuxing-searxng
# 然后重新运行启动命令

Параметры конфигурации

Настройка MCP-сервера через переменные окружения:

Добавьте эти переменные в поле env конфигурации Claude Code для настройки поведения.

Устранение неполадок

Проблема 1: Инструменты поиска не отображаются или выдают ошибку

Чек-лист:

1. ✅ Запущен ли контейнер SearXNG?

   docker ps | grep wuxing-searxng

2. ✅ Работает ли сервис SearXNG нормально?

   curl http://localhost:18080

3. ✅ Правильно ли указан путь к файлу конфигурации (используется ли абсолютный путь)?

4. ✅ Версия Node.js >= 18?

   node --version

5. ✅ Был ли перезапущен Claude Code?

Проблема 2: Контейнер SearXNG не запускается

Проверка:

1. Занят ли порт 18080?

   # Windows
   netstat -ano | findstr :18080
   
   # Linux/Mac
   lsof -ti:18080

2. Запущен ли сервис Docker?

3. Проверьте логи контейнера:

   docker logs wuxing-searxng

Решение:

# 删除旧容器并重新创建
docker stop wuxing-searxng && docker rm wuxing-searxng
# 然后重新运行启动命令

Проблема 3: Поиск возвращает ошибку соединения

Возможная причина: Сервис SearXNG еще не полностью запущен

Решение:

# 等待 5-10 秒后重试
# 或重启 SearXNG
docker restart wuxing-searxng

Проблема 4: Результаты содержат устаревший контент

Причина: Фильтрация по времени зависит от поддержки поисковой системы

Решение:

1. Используйте более короткий временной диапазон (day вместо week)

2. Добавьте явные временные ключевые слова в запрос (например, январь 2025)

3. Используйте комбинацию:

   请搜索 2025年1月的 React 新特性

Техническая архитектура

MCP Server (Node.js)

• Файл: src/index.js

• Зависимости: @modelcontextprotocol/sdk, axios

• Связь: stdio (стандартный ввод/вывод)

• Роль: реализация протокола MCP, пересылка запросов в SearXNG

SearXNG (Python/Docker)

• Образ: searxng/searxng:latest

• Порт: 18080 (хост) → 8080 (контейнер)

• Конфигурация: searxng/config/settings.yml

• Данные: searxng/data/ (кэш)

• Роль: агрегация 100+ поисковых систем

Поток данных

用户输入
  → Claude Code
  → MCP Server (stdio)
  → HTTP 请求到 SearXNG
  → 并发请求到各搜索引擎
  → 聚合结果
  → 返回给用户

Структура проекта

wuxing-search-mcp/
├── src/                  # MCP Server 源码
│   └── index.js         # MCP Server 主实现
├── searxng/             # SearXNG 配置
│   ├── config/          # SearXNG settings.yml
│   └── data/            # SearXNG 缓存（自动创建）
├── assets/              # 文档图片
│   └── banner.png       # 项目横幅
├── package.json         # NPM 包配置
├── docker-compose.yml   # Docker Compose 配置
├── install.sh           # Linux/Mac 安装脚本
├── install.ps1          # Windows 安装脚本
├── README.md            # 英文版
├── README.zh-CN.md      # 中文版（本文件）
└── INSTALL.md           # 详细安装指南

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

В: Зачем нужен Docker?

О: SearXNG — это проект на Python, зависящий от 50+ пакетов Python. Docker обеспечивает:

• Избежание сложной ручной установки зависимостей

• Изоляцию среды

• Упрощение развертывания и обновлений

В: Можно ли обойтись без Docker?

О: Теоретически можно, но не рекомендуется. Вам потребуется:

1. Установить Python 3.14

2. Вручную установить 50+ зависимостей Python

3. Настроить среду Python

Вариант с Docker проще и надежнее.

В: Есть ли лимиты на поиск?

О: Нет! Это главное преимущество проекта:

• Полностью самостоятельный хостинг

• Нет ограничений на вызовы API

• Нет ограничений по частоте запросов

В: Какие поисковые системы поддерживаются?

О: SearXNG поддерживает 245 поисковых систем, 89 включены по умолчанию.

Текущие 21 включенный движок:

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

• Код: Bitbucket, Codeberg, Gitea, SourceHut

• Пакеты: RubyGems, Go, Hex, Packagist

• Социальные сети: Lemmy

• Видео: YouTube, Vimeo, Bilibili

• И другие...

В: Каково качество поиска?

О: Зависит от включенных поисковых систем. Конфигурация по умолчанию уже включает основные поисковые системы, качество хорошее. Если требуется настройка, можно отредактировать searxng/config/settings.yml.

Вклад в проект

Приветствуется вклад сообщества! Вы можете помочь нам так:

1. Fork этого репозитория

2. Создайте ветку функций (git checkout -b feature/amazing-feature)

3. Зафиксируйте изменения (git commit -m 'Add amazing feature')

4. Отправьте в ветку (git push origin feature/amazing-feature)

5. Откройте Pull Request

Способы участия

• Улучшение конфигурации поисковых систем

• Добавление новых функций в MCP-сервер

• Сообщение об ошибках и проблемах

• Предложение новых функций

• Улучшение документации

• Обмен вашими отзывами

Ресурсы

📚 Документация

• Руководство по установке - подробные инструкции

• Документация SearXNG - официальная документация

• Спецификация MCP - протокол контекста модели

🌐 Официальный сайт

• Блог Wuxing Codes - последние обновления и руководства

💬 Сообщество

• GitHub Issues - сообщение о проблемах

• GitHub Discussions - вопросы

Лицензия

MIT License - подробнее см. файл LICENSE.

Благодарности

• Построено на базе проекта с открытым исходным кодом SearXNG

• Создано для сообщества Claude Code

• Является частью экосистемы Wuxing Codes

Сделано с ❤️ командой Wuxing

⭐ Поставьте нам звезду на GitHub — это очень помогает!