Wuxing Search
Wuxing Search MCP is a powerful, unlimited search server built on top of SearXNG. It integrates seamlessly with Claude Code via the Model Context Protocol, providing free and unlimited search capabilities by aggregating results from 100+ search engin
What is Wuxing Search?
Wuxing Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to wuxing search mcp is a powerful, unlimited search server built on top of searxng. it integrates seamlessly with claude code via the model context protocol, providing free and unlimited search capabili...
Wuxing Search MCP is a powerful, unlimited search server built on top of SearXNG. It integrates seamlessly with Claude Code via the Model Context Protocol, providing free and unlimited search capabilities by aggregating results from 100+ search engin
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Wuxing Search MCP is a powerful, unlimited search server bui
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx wuxing-searchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Wuxing Search
Wuxing Search MCP is a Node.js-based MCP server that provides unlimited, free web search by running a self-hosted SearXNG instance in Docker and aggregating results from 100+ search engines including Google, Bing, DuckDuckGo, GitHub, Stack Overflow, arXiv, npm, PyPI, and HackerNews. It integrates with Claude Code, Cursor, Windsurf, and other AI IDEs via the MCP stdio transport with no API costs or rate limits.
Prerequisites
- Docker and Docker Compose installed
- Node.js 18 or higher installed
- Git to clone the repository
- Claude Code, Claude Desktop, Cursor, or Windsurf
Clone the repository
Clone the wuxing-search-mcp repository to your local machine.
git clone https://github.com/MaesHughes/wuxing-search-mcp.git
cd wuxing-search-mcpInstall Node.js dependencies
Install the required npm packages for the MCP server.
npm installStart the SearXNG backend
Launch the SearXNG search aggregator in Docker. The recommended method uses a single Docker run command. SearXNG will be available on port 18080.
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:latestGet the absolute path to src/index.js
The MCP config requires the full absolute path to the server entry point. Run this command to get it.
# macOS / Linux:
pwd && echo "/src/index.js"
# Combine: e.g. /Users/yourname/wuxing-search-mcp/src/index.js
# Windows (PowerShell):
Resolve-Path src\index.jsAdd the server to your MCP client configuration
Edit your client's config file (Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the wuxing-search entry. Set SEARXNG_URL to point to the running Docker container.
{
"mcpServers": {
"wuxing-search": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/wuxing-search-mcp/src/index.js"],
"env": {
"SEARXNG_URL": "http://localhost:18080",
"MAX_RESULTS": "20",
"TIMEOUT": "30000"
}
}
}
}Restart your AI client and verify search works
Restart Claude Code or Claude Desktop. Ask Claude to search for something and confirm results are returned from the SearXNG backend.
Wuxing Search Examples
Client configuration
claude_desktop_config.json entry for Wuxing Search MCP on macOS/Linux with SearXNG running on port 18080.
{
"mcpServers": {
"wuxing-search": {
"type": "stdio",
"command": "node",
"args": ["/Users/yourname/wuxing-search-mcp/src/index.js"],
"env": {
"SEARXNG_URL": "http://localhost:18080",
"MAX_RESULTS": "20",
"TIMEOUT": "30000"
}
}
}
}Prompts to try
Example search prompts that use the Wuxing Search MCP backend through Claude.
- "Search for the latest news about Model Context Protocol"
- "Find Stack Overflow answers for Python asyncio timeout handling"
- "Search GitHub for open source MCP server implementations"
- "Look up the npm package express and show its latest version"
- "Search arXiv for recent papers on retrieval-augmented generation published this month"
- "Find Reddit discussions about self-hosted AI tools"Troubleshooting Wuxing Search
SearXNG container fails to start or exits immediately
Run docker logs wuxing-searxng to see the error. A common issue is the searxng/config directory not existing. Run mkdir -p searxng/config searxng/data inside the repository root before starting the container.
MCP server returns 'connection refused' when trying to search
Confirm SearXNG is running with docker ps | grep wuxing-searxng and that SEARXNG_URL in your config matches the port (default 18080). Try curl http://localhost:18080/search?q=test&format=json to test the endpoint directly.
Search results are empty or return an error about rate limiting
The SearXNG instance needs rate limiting disabled for high-frequency use. Check the searxng/config/settings.yml file and set limiter: false under the server section, then restart the container.
Frequently Asked Questions about Wuxing Search
What is Wuxing Search?
Wuxing Search is a Model Context Protocol (MCP) server that wuxing search mcp is a powerful, unlimited search server built on top of searxng. it integrates seamlessly with claude code via the model context protocol, providing free and unlimited search capabilities by aggregating results from 100+ search engin It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Wuxing Search?
Follow the installation instructions on the Wuxing Search GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Wuxing Search?
Wuxing Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Wuxing Search free to use?
Yes, Wuxing Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Wuxing Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Wuxing Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Wuxing Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Wuxing Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.