兼容 Claude Code、Cursor、Windsurf 和其他 AI 驱动的 IDE

Wuxing Search MCP

基于 SearXNG 的无限制搜索 MCP Server

一个强大的无限制搜索服务器，聚合 100+ 搜索引擎

功能特点 • 快速开始 • 安装 • 使用方法 • 管理命令 • 故障排查

什么是 Wuxing Search MCP？

Wuxing Search MCP 是一个基于 SearXNG 构建的强大无限制搜索服务器。它通过模型上下文协议与 Claude Code 无缝集成，通过聚合 100+ 搜索引擎的结果，提供免费且无限制的搜索能力。

为什么选择 Wuxing Search？

传统搜索 API 存在限制：

• ❌ 速率限制和配额
• ❌ 昂贵的 API 成本
• ❌ 单一来源的结果

Wuxing Search 解决了所有这些问题：

• ✅ 完全免费 - 自建 SearXNG，无 API 成本
• ✅ 无限制搜索 - 禁用速率限制器，支持高频搜索
• ✅ 多源聚合 - Google、Bing、DuckDuckGo、Brave 等 100+ 引擎
• ✅ 隐私友好 - 无追踪，无记录
• ✅ MCP 集成 - 完美适配 Claude Code 工作流

架构说明

┌─────────────┐      ┌──────────────┐      ┌─────────────┐      ┌─────────────┐
│  你        │ ───▶ │ Claude Code │ ───▶ │ Wuxing      │ ───▶ │  SearXNG    │
│  (用户)    │      │  (MCP 客户端) │      │ Search MCP   │      │ (Docker)    │
└─────────────┘      └──────────────┘      │ (Node.js)   │      │ (Python)    │
                                            └──────────────┘      └─────────────┘
                                                    │
                                                    ▼
                                            ┌───────────────────────────┐
                                            │   搜索引擎聚合           │
                                            │   - Google               │
                                            │   - Bing                 │
                                            │   - DuckDuckGo           │
                                            │   - Brave                │
                                            │   - Wikipedia            │
                                            │   - 以及 100+ 更多...    │
                                            └───────────────────────────┘

功能特点

✨ 当前功能

• 🔍 无限制网页搜索

  • 无 API 速率限制或配额
  • 支持高频搜索
  • 可配置结果数量（1-100）

• 🌐 多源聚合

  • Google、Bing、DuckDuckGo、Brave
  • Wikipedia、GitHub、Stack Overflow
  • 支持 100+ 搜索引擎

• 📊 高级搜索选项

  • 时间范围过滤（天、周、月、年）
  • 类别过滤（通用、图片、视频、新闻、IT、科学、文件、社交）
  • 语言过滤
  • 安全搜索级别

• 🔌 MCP 集成

  • 与 Claude Code 无缝集成
  • stdio 通信（MCP 不需要网络端口）
  • JSON-RPC 2.0 协议

• 🐳 简单部署

  • 基于 Docker 的 SearXNG 部署
  • 一键安装
  • 跨平台支持（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

方式 A：使用 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

方式 B：使用 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

第一步：获取你的项目路径

在项目目录下运行以下命令获取绝对路径：

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

第二步：添加配置

在配置文件中添加以下配置，⚠️ 务必替换 YOUR_FULL_PATH_HERE 为上一步获取的实际路径：

Windows 配置示例

{
  "mcpServers": {
    "wuxing-search": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "D:\\\\indieHacker\\\\AI\\\\tools-series\\\\MCP\\\\wuxing-search\\\\src\\\\index.js"
      ],
      "env": {
        "