mcp-searxng

Overview

The mcp-searxng is a robust MCP server that integrates with any SearXNG instance via HTTP API, enabling AI assistants to perform web searches and read URL content. It provides advanced features like pagination, time filtering, language selection, and safe search controls. The server supports multiple deployment methods including NPM, Docker, and Docker Compose, with options for both STDIO and HTTP transport modes. Intelligent caching reduces redundant requests and improves performance when retrieving URL content.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• searxng_web_searchquery: string, pageno?: number, time_range?: string, language?: string, safesearch?: number

  Execute web searches with pagination using SearXNG

  Try:Search for recent news about artificial intelligenceTry:Find articles about renewable energy from the last monthTry:Search in French for recipes with chicken
• web_url_readurl: string, startChar?: number, maxLength?: number, section?: string, paragraphRange?: string, readHeadings?: boolean

  Read and convert web content from a URL to markdown with extraction options

  Try:Extract the main content from https://example.com/articleTry:Get the first 3 paragraphs from https://example.com/blogTry:List all headings from https://example.com/document

Comparable tools

Installation

npm install -g mcp-searxng

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

docker pull isokoliuk/mcp-searxng:latest

{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEARXNG_URL",
        "isokoliuk/mcp-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}

FAQ

Is this a SearXNG plugin?

No, this is a standalone MCP server that connects to any existing SearXNG instance via HTTP API, not a native SearXNG plugin.

How do I handle 403 Forbidden errors from SearXNG?

Your SearXNG instance likely has JSON format disabled. Edit settings.yml to include 'json' in the search formats list, then restart SearXNG.

Compare mcp-searxng with