Skip to main content
Glama
fighter3005

searxng-mcp

by fighter3005

searxng-mcp

MCP server for web search via a self-hosted SearXNG instance.

Provides a single search_web tool that queries your SearXNG instance and returns structured results (title, URL, snippet).

Setup

1. Set environment variable

export SEARXNG_BASE_URL="http://searxng:8080"

Optional:

export SEARXNG_LANGUAGE="en-US"
export SEARXNG_CATEGORIES="general"
export SEARXNG_ENGINES="google,bing"
export SEARXNG_TIME_RANGE="month"
export SEARXNG_SAFESEARCH="1"
export SEARXNG_USER_AGENT="my-app/1.0"
export SEARXNG_HEADERS_JSON='{"Authorization":"Bearer ..."}'
export SEARXNG_TIMEOUT_SECONDS="30"

2. Run

No install needed — run directly from GitHub with uvx:

uvx --from "git+https://github.com/fighter3005/search-mcp" searxng-mcp

Or from a local clone:

uvx --from /path/to/search-mcp searxng-mcp

Related MCP server: searxng-mcp

Client configuration

Claude Code

claude mcp add --transport stdio searxng-search \
  -e SEARXNG_BASE_URL="http://searxng:8080" \
  -- uvx --from "git+https://github.com/fighter3005/search-mcp" searxng-mcp

Codex

codex mcp add searxng-search \
  --env SEARXNG_BASE_URL="http://searxng:8080" \
  -- uvx --from "git+https://github.com/fighter3005/search-mcp" searxng-mcp

Cursor / VS Code

Create .cursor/mcp.json or .vscode/mcp.json:

With uvx from GitHub:

{
  "mcpServers": {
    "searxng-search": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fighter3005/search-mcp", "searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://searxng:8080"
      }
    }
  }
}

After install:

{
  "mcpServers": {
    "searxng-search": {
      "command": "searxng-mcp",
      "env": {
        "SEARXNG_BASE_URL": "http://searxng:8080"
      }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json:

With uvx from GitHub (no install needed):

{
  "mcpServers": {
    "searxng-search": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fighter3005/search-mcp", "searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://searxng:8080"
      }
    }
  }
}

After install (pip install -e .):

{
  "mcpServers": {
    "searxng-search": {
      "command": "searxng-mcp",
      "env": {
        "SEARXNG_BASE_URL": "http://searxng:8080"
      }
    }
  }
}

LiteLLM / Anthropic

Add to your config.yaml:

mcp_servers:
  searxng-search:
    command: uvx
    args:
      - "--from"
      - "git+https://github.com/fighter3005/search-mcp"
      - "searxng-mcp"
    env:
      SEARXNG_BASE_URL: "http://searxng:8080"

Or as a JSON litellm_config:

{
  "mcp_servers": {
    "searxng-search": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fighter3005/search-mcp", "searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://searxng:8080"
      }
    }
  }
}

Tool

Tool

Parameters

Description

search_web

query (str), num_results (int, default 5)

Search the web via SearXNG

Returns {"results": [{"title": str, "url": str, "snippet": str}, ...]}.

Requirements

  • Python 3.11+

  • A running SearXNG instance with JSON format enabled

Install Server
F
license - not found
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (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
    -
    quality
    D
    maintenance
    An MCP server that wraps a local SearXNG instance to provide private, customizable web search capabilities. It enables AI assistants to perform queries with support for specific parameters like results limits, language, and time ranges.
    Last updated
    248
    MIT
  • F
    license
    A
    quality
    A
    maintenance
    An MCP server for SearXNG that provides web search capabilities with concise model-visible output while preserving full result payloads in metadata. It supports search, parallel fetching, URL extraction, and research workflows through both local stdio and streamable HTTP transports.
    Last updated
    7

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

  • Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

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/fighter3005/search-mcp'

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