MCPgee
MCPgee
MCPgeeMCPgee

SearXNG Server

v1.0.3•Search & Data Extraction•stable

An MCP server implementation that integrates the SearxNG API, providing web search capabilities.

aillmllm-agentmcpmcp-server
Share:
803
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is SearXNG Server?

SearXNG Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server implementation that integrates the searxng api, providing web search capabilities.

An MCP server implementation that integrates the SearxNG API, providing web search capabilities.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server implementation that integrates the SearxNG API

Use Cases

SearXNG API integration for web search
Unified search tool for AI agents
ihor-sokoliuk

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.3
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y mcp-searxng

Manual Installation

npx -y mcp-searxng

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SearXNG Server

The SearXNG MCP Server integrates any self-hosted or public SearXNG metasearch instance with AI assistants through the Model Context Protocol, providing privacy-respecting web search without sending queries to centralized commercial search APIs. It exposes four tools — web search with filtering, search suggestions, instance metadata discovery, and URL content extraction — making it a versatile search backbone for AI agents. Teams running their own SearXNG instances use it to give Claude or other MCP clients access to unified, untracked web search results.

Prerequisites

  • A running SearXNG instance (self-hosted or a public instance URL)
  • Node.js 18 or later for the npx installation
  • An MCP client such as Claude Desktop
  • The SEARXNG_URL environment variable pointing to your SearXNG instance
1

Confirm your SearXNG instance is accessible

Test that your SearXNG instance responds to JSON API requests before connecting the MCP server.

curl "https://your-searxng-instance.com/search?q=test&format=json"
2

Install the MCP server package

Install mcp-searxng globally or use npx to run it on demand.

npm install -g mcp-searxng
# or use npx without installing:
npx -y mcp-searxng
3

Set the required environment variable

Export the SEARXNG_URL variable pointing to your SearXNG instance. This is required — the server will not start without it.

export SEARXNG_URL=https://your-searxng-instance.com
4

Configure Claude Desktop

Add the server to your claude_desktop_config.json with the SEARXNG_URL in the env block.

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.com"
      }
    }
  }
}
5

Verify the connection

Restart Claude Desktop and ask it to perform a web search. The searxng_web_search tool should appear in the available tools list.

SearXNG Server Examples

Client configuration

Complete Claude Desktop configuration for the SearXNG MCP server.

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "mcp-searxng"],
      "env": {
        "SEARXNG_URL": "https://your-searxng-instance.com",
        "SEARXNG_MAX_RESULTS": "10"
      }
    }
  }
}

Prompts to try

Example search queries to run once the MCP server is connected.

- "Search the web for recent news about open-source LLM releases"
- "Find academic papers on retrieval-augmented generation published in 2024"
- "Get search suggestions for the query 'vector database'"
- "Fetch the content of https://example.com and summarize it"

Troubleshooting SearXNG Server

Server fails to start with 'SEARXNG_URL is required'

Ensure SEARXNG_URL is set in the env block of your MCP client config, not just as a shell export. The MCP client spawns a new process and does not inherit shell environment variables.

Search returns empty results or connection refused errors

Verify the SearXNG instance is running and publicly accessible at the configured URL. Test it directly with curl. Some public SearXNG instances rate-limit or block automated requests.

web_url_read tool fails on certain pages

Some pages block server-side fetching or require JavaScript rendering. Try a different URL or use the search tool to find a cached version of the content.

Frequently Asked Questions about SearXNG Server

What is SearXNG Server?

SearXNG Server is a Model Context Protocol (MCP) server that mcp server implementation that integrates the searxng api, providing web search capabilities. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SearXNG Server?

Install via npm with the command: npx -y mcp-searxng. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with SearXNG Server?

SearXNG Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SearXNG Server free to use?

Yes, SearXNG Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

SearXNG Server Alternatives — Similar Search & Data Extraction Servers

Looking for alternatives to SearXNG Server? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.

TrendRadar

★ 58.0k

A 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.2k

An autonomous agent that conducts deep research on any data using any LLM providers

Agent Reach

★ 20.1k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Xiaohongshu

★ 13.7k

MCP 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.

Search & Data ExtractionBrowse All Servers

Quick Config Preview

{ "mcpServers": { "searxng-server": { "command": "npx", "args": ["-y", "mcp-searxng"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SearXNG Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides