Wuxing Search MCP

Was ist Wuxing Search MCP?

Wuxing Search MCP ist ein leistungsstarker, unbegrenzter Suchserver, der auf SearXNG basiert. Er lässt sich über das Model Context Protocol nahtlos in Claude Code integrieren und bietet kostenlose, unbegrenzte Suchfunktionen durch die Aggregation von Ergebnissen aus über 100 Suchmaschinen.

Warum Wuxing Search wählen?

Herkömmliche Such-APIs haben Einschränkungen:

• ❌ Ratenbegrenzungen und Kontingente

• ❌ Hohe API-Kosten

• ❌ Ergebnisse aus einer einzigen Quelle

Wuxing Search löst all diese Probleme:

• ✅ Völlig kostenlos - Selbst gehostetes SearXNG, keine API-Kosten

• ✅ Unbegrenzte Suche - Ratenbegrenzer deaktiviert, unterstützt hochfrequente Suchen

• ✅ Multi-Quellen-Aggregation - Über 100 Suchmaschinen wie Google, Bing, DuckDuckGo, Brave usw.

• ✅ Datenschutzfreundlich - Kein Tracking, keine Protokollierung

• ✅ MCP-Integration - Perfekt angepasst an den Claude Code-Workflow

Related MCP server: SearXNG MCP Server

Architekturhinweise

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

Funktionsmerkmale

✨ Aktuelle Funktionen

• 🔍 Unbegrenzte Websuche

  • Keine API-Ratenbegrenzungen oder Kontingente

  • Unterstützung für hochfrequente Suchen

  • Konfigurierbare Anzahl der Ergebnisse (1-100)

• 🌐 Multi-Quellen-Aggregation

  • Allgemein: Google, Bing, DuckDuckGo, Baidu

  • Code: GitHub, Hugging Face, GitLab

  • Q&A: Stack Overflow

  • Pakete: npm, PyPI, crates.io, Docker Hub

  • Akademisch: arXiv, Google Scholar, Semantic Scholar, PubMed

  • Community: HackerNews, Reddit, Mastodon

  • Dokumentation: MDN

  • Nachrichten: Google News

  • Unterstützung für über 100 Suchmaschinen

• 📊 Erweiterte Suchoptionen

  • Zeitbereichsfilter (Tag, Woche, Monat, Jahr)

  • Kategoriefilter (Allgemein, Bilder, Videos, Nachrichten, IT, Wissenschaft, Dateien, Soziales)

  • Sprachfilter

  • SafeSearch-Stufen

• 🔌 MCP-Integration

  • Nahtlose Integration mit Claude Code

  • stdio-Kommunikation (MCP benötigt keine Netzwerk-Ports)

  • JSON-RPC 2.0 Protokoll

• 🐳 Einfache Bereitstellung

  • Docker-basierte SearXNG-Bereitstellung

  • Ein-Klick-Installation

  • Plattformübergreifende Unterstützung (Windows, macOS, Linux)

• 🔒 Datenschutz zuerst

  • Kein Tracking, keine Protokollierung

  • Selbst gehostet, Daten verlassen niemals Ihren Rechner

  • Anonyme Suche über SearXNG

Schnellstart

In 4 einfachen Schritten loslegen:

Voraussetzungen

• Docker (erforderlich): Download

• Node.js 18+ (erforderlich): Download

1. Projekt klonen

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

2. Abhängigkeiten installieren

npm install

3. SearXNG starten

Methode A: Docker-Befehl verwenden (empfohlen)

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

Methode B: Docker Compose verwenden

docker-compose up -d

4. Claude Code konfigurieren

Suchen Sie Ihre Claude Code-Konfigurationsdatei:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS / Linux:

~/.config/Claude/claude_desktop_config.json

Schritt 1: Pfad Ihres Projekts abrufen

Führen Sie im Projektverzeichnis den folgenden Befehl aus, um den absoluten Pfad zu erhalten:

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

Schritt 2: Konfiguration hinzufügen

Fügen Sie die folgende Konfiguration zur Konfigurationsdatei hinzu, ⚠️ ersetzen Sie unbedingt YOUR_FULL_PATH_HERE durch den tatsächlichen Pfad aus dem vorherigen Schritt:

Windows-Konfigurationsbeispiel

{
  "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-Konfigurationsbeispiel

{
  "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"
      }
    }
  }
}

Konfigurationshinweise:

⚠️ Wichtiger Hinweis:

• Backslashes in Windows-Pfaden müssen als doppelte Backslashes \\ maskiert werden (JSON-Format-Anforderung)

• Alternativ können Schrägstriche / verwendet werden (Windows unterstützt diese ebenfalls)

• Der Pfad muss ein absoluter Pfad sein, relative Pfade funktionieren nicht

• Nach dem Ändern der Konfiguration muss Claude Code vollständig neu gestartet werden, damit die Änderungen wirksam werden

5. Claude Code neu starten

Beenden Sie Claude Code vollständig und öffnen Sie es erneut.

Verwendung

Grundlegende Suche

Geben Sie direkt in Claude Code ein:

请搜索最新的 AI 编程工具

Erweiterte Suchparameter

Sie können auch Parameter angeben:

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

Verfügbare Tools

1. web_search

Führt eine Websuche durch und gibt Ergebnisse zurück.

Kategorieoptionen:

• general - Allgemeine Suche

• images - Bildersuche

• videos - Videosuche

• news - Nachrichtensuche

• it - IT-Technik

• science - Wissenschaft

• files - Dateien

• social - Soziale Medien

Zeitbereichsoptionen:

• day - Letzte 24 Stunden

• week - Letzte Woche

• month - Letzter Monat

• year - Letztes Jahr

• none - Kein Zeitfilter

2. get_server_info

Ruft Statusinformationen des Suchservers ab. Keine Parameter.

Anwendungsbeispiele

Beispiel 1: Open-Source-Projekt suchen

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

Beispiel 2: Technische Frage suchen

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

Beispiel 3: Akademische Arbeit suchen

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

Beispiel 4: Python-Bibliothek suchen

在 PyPI 上搜索 LangChain agents 相关的包

Beispiel 5: Entwicklerdiskussion suchen

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

Beispiel 6: Serverstatus abfragen

查询搜索服务器状态

Verwaltungsbefehle

NPM-Befehle

# 查看 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-Befehle

# 查看容器状态
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
# 然后重新运行启动命令

Konfigurationsoptionen

Konfiguration des MCP-Servers über Umgebungsvariablen:

Fügen Sie diese Variablen im env-Feld der Claude Code-Konfiguration hinzu, um das Verhalten anzupassen.

Fehlerbehebung

Problem 1: Such-Tools werden nicht angezeigt oder verursachen Fehler

Checkliste:

1. ✅ Läuft der SearXNG-Container?

   docker ps | grep wuxing-searxng

2. ✅ Funktioniert der SearXNG-Service ordnungsgemäß?

   curl http://localhost:18080

3. ✅ Ist der Pfad der Konfigurationsdatei korrekt (absoluten Pfad verwenden)?

4. ✅ Ist die Node.js-Version >= 18?

   node --version

5. ✅ Wurde Claude Code neu gestartet?

Problem 2: SearXNG-Container startet nicht

Prüfung:

1. Ist Port 18080 belegt?

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

2. Läuft der Docker-Service?

3. Container-Logs prüfen:

   docker logs wuxing-searxng

Lösung:

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

Problem 3: Suche gibt Verbindungsfehler zurück

Mögliche Ursache: SearXNG-Service ist noch nicht vollständig gestartet

Lösung:

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

Problem 4: Ergebnisse enthalten veraltete Inhalte

Ursache: Zeitfilter hängen von der Unterstützung der Suchmaschine ab

Lösung:

1. Kürzere Zeitbereiche verwenden (day statt week)

2. Explizite Zeitbegriffe in der Query hinzufügen (z. B. Januar 2025)

3. Kombination verwenden:

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

Technische Architektur

MCP-Server (Node.js)

• Datei: src/index.js

• Abhängigkeiten: @modelcontextprotocol/sdk, axios

• Kommunikation: stdio (Standard Input/Output)

• Aufgabe: Implementierung des MCP-Protokolls, Weiterleitung von Anfragen an SearXNG

SearXNG (Python/Docker)

• Image: searxng/searxng:latest

• Port: 18080 (Host) → 8080 (Container)

• Konfiguration: searxng/config/settings.yml

• Daten: searxng/data/ (Cache)

• Aufgabe: Aggregation von über 100 Suchmaschinen

Datenfluss

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

Projektstruktur

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           # 详细安装指南

Häufig gestellte Fragen (FAQ)

F: Warum wird Docker benötigt?

A: SearXNG ist ein Python-Projekt und hängt von über 50 Python-Paketen ab. Docker bietet:

• Vermeidung komplexer manueller Abhängigkeitsinstallationen

• Umgebungsisolierung

• Vereinfachte Bereitstellung und Updates

F: Kann man es ohne Docker verwenden?

A: Theoretisch ja, aber nicht empfohlen. Sie müssten:

1. Python 3.14 installieren

2. Über 50 Python-Abhängigkeiten manuell installieren

3. Die Python-Umgebung konfigurieren

Die Docker-Lösung ist einfacher und zuverlässiger.

F: Gibt es ein Limit für die Suche?

A: Nein! Das ist der Kernvorteil dieses Projekts:

• Vollständig selbst gehostet

• Keine API-Aufrufbeschränkungen

• Keine Ratenbegrenzungen

F: Welche Suchmaschinen werden unterstützt?

A: SearXNG unterstützt 245 Suchmaschinen, 89 sind standardmäßig aktiviert.

Aktuell aktivierte 21 Engines:

Weitere verfügbare Engines (können in der Konfiguration aktiviert werden):

• Code: Bitbucket, Codeberg, Gitea, SourceHut

• Paketverwaltung: RubyGems, Go, Hex, Packagist

• Soziales: Lemmy

• Video: YouTube, Vimeo, Bilibili

• Und mehr...

F: Wie ist die Suchqualität?

A: Hängt von den aktivierten Suchmaschinen ab. Die Standardkonfiguration enthält bereits die wichtigsten Suchmaschinen und bietet eine gute Qualität. Bei Bedarf können Sie searxng/config/settings.yml bearbeiten.

Mitwirken

Beiträge aus der Community sind willkommen! So können Sie uns helfen:

1. Forken Sie dieses Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/amazing-feature)

3. Commiten Sie Ihre Änderungen (git commit -m 'Add amazing feature')

4. Pushen Sie den Branch (git push origin feature/amazing-feature)

5. Öffnen Sie einen Pull Request

Möglichkeiten zur Mitwirkung

• Verbesserung der Suchmaschinenkonfiguration

• Hinzufügen neuer Funktionen zum MCP-Server

• Melden von Bugs und Problemen

• Vorschlagen neuer Funktionen

• Verbesserung der Dokumentation

• Teilen Ihres Feedbacks

Ressourcen

📚 Dokumentation

• Installationsanleitung - Detaillierte Installationsanweisungen

• SearXNG-Dokumentation - Offizielle SearXNG-Dokumentation

• MCP-Spezifikation - Model Context Protocol

🌐 Offizielle Website

• Wuxing Codes Blog - Aktuelle Updates und Tutorials

💬 Community

• GitHub Issues - Probleme melden

• GitHub Discussions - Fragen stellen

Lizenz

MIT License - Siehe LICENSE Datei für Details.

Danksagungen

• Aufgebaut auf dem Open-Source-Projekt SearXNG

• Entwickelt für die Claude Code-Community

• Teil des Wuxing Codes-Ökosystems

Mit ❤️ vom Wuxing-Team erstellt

⭐ Geben Sie uns einen Stern auf GitHub — das hilft uns sehr!