Skip to main content
Glama

mcp_searxng

MCP server for privacy-respecting web search via SearXNG.

Requires pi-mcp-bridge to connect to pi.

Prerequisites

  • SearXNG instance running (default: http://localhost:8080/searxng)

Related MCP server: mcp_server_searXNG

Installation

pip install git+https://github.com/timaliev/mcp_searxng.git

Or via uv:

uv tool install git+https://github.com/timaliev/mcp_searxng.git

Configuration

With pi-mcp-bridge

In ~/.pi/agent/settings.json:

{
  "mcpBridge": {
    "servers": [
      {
        "name": "searxng",
        "command": "mcp-searxng",
        "args": [],
        "env": {
          "SEARXNG_URL": "http://localhost:8080/searxng"
        },
        "setupCommands": [
          "uv tool install --python 3.11 git+https://github.com/timaliev/mcp_searxng.git"
        ],
        "githubRepo": "timaliev/mcp_searxng",
        "versionCommand": "mcp-searxng --version"
      }
    ]
  }
}

Standalone MCP client

In ~/.mcp.json:

{
  "mcpServers": {
    "searxng": {
      "command": "mcp-searxng",
      "args": [],
      "env": {
        "SEARXNG_URL": "http://localhost:8080/searxng"
      }
    }
  }
}

Environment Variables

Variable

Default

Description

SEARXNG_URL

http://localhost:8080/searxng

SearXNG instance URL

Tools

Tool

Description

search_web

Web search with engine/category/language filters

search_news

News-only search

search_images

Image search with thumbnails

list_engines

List available/enabled SearXNG engines

Error Handling

All tools return a structured response with a success field. If SearXNG is unreachable or returns an error, success will be false with an error code and detail:

Error Code

Cause

ECONNREFUSED

SearXNG instance is not running or not reachable at the configured SEARXNG_URL

ESEARCH

SearXNG returned an HTTP error (e.g., 500)

EPROCESSING

Unexpected error while processing the request

Example error response:

{
  "success": false,
  "error": "ECONNREFUSED",
  "detail": "Cannot reach SearXNG at http://localhost:8080/searxng"
}

The server does not crash or exit — errors are returned inline so the agent can handle them gracefully.

Development

git clone https://github.com/timaliev/mcp_searxng.git
cd mcp_searxng
uv run mcp-searxng
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
1dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that enables web search capabilities by integrating with a SearXNG instance to aggregate results from over 130 engines. It allows users to perform filtered searches across categories like news, science, and social media while supporting advanced parameters for language and time range.
    9
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A privacy-friendly web search MCP server using SearXNG, enabling searches across multiple engines and categories.
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Privacy-focused web search MCP server using SearXNG with Streamable HTTP transport, supporting authentication and advanced search parameters.

View all related MCP servers

Related MCP Connectors

  • Serper MCP — wraps the Serper Google Search API (serper.dev)

  • MCP server for Google search results via SERP API

  • An MCP server for deep research or task groups

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/timaliev/mcp_searxng'

If you have feedback or need assistance with the MCP directory API, please join our Discord server