Wuxing Search

Provides unlimited, privacy-friendly web search by aggregating 100+ engines via SearXNG and integrates with Claude Code MCP.

typescript

6

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Wuxing Search MCP is a self-hosted MCP server that enables unlimited web search by aggregating results from 100+ search engines through a SearXNG-based backend, and it integrates with Claude Code to provide fast, privacy-friendly search via the MCP workflow.

How to use

You will interact with this MCP server through an MCP client like Claude Code. Configure the client to launch the Wuxing Search MCP locally, then issue search requests in the client. The MCP server forwards your queries to SearXNG, aggregates results from many engines, and returns unified results back to your client. This setup lets you perform high-frequency, multi-source searches with no API rate limits and without sending data to external providers.

How to install

Prerequisites you need before installation:

Docker is required to run the SearXNG backend.
Node.js 18+ is required to run the MCP server.

Step-by-step installation

Clone the project and navigate into it.
Install dependencies.

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

npm install

Start SearXNG (Docker)

Choose one of the following options to start the SearXNG service.

# Option A: Docker command (recommended)
docker run -d \
  --name wuxing-searxng \
  --restart unless-stopped \
  -p 8888:8080 \
  -v "$(pwd)/searxng/config:/etc/searxng/" \
  -v "$(pwd)/searxng/data:/var/cache/searxng/" \
  searxng/searxng:latest

# Option B: Docker Compose
docker-compose up -d

Configure Claude Code

In Claude Code, add a configuration entry that runs the MCP server locally. The CLI-based setup uses a stdio MCP under Node.js and points to the MCP index.

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

Restart Claude Code

Fully quit and reopen Claude Code after saving the MCP configuration to apply changes.

Additional notes

If you need to adjust search behavior, modify the SearXNG configuration inside the searxng/config/settings.yml or tune the MAX_RESULTS and TIMEOUT values in the MCP environment variables.

Troubleshooting

Refer to the common issues and remedies to resolve problems quickly.

Ensure the SearXNG container is running and healthy.

Available tools

web_search

Execute web searches and return results with configurable parameters such as max_results, category, language, time_range, and safesearch.

get_server_info

Retrieve the MCP server status information.