Which integrations are available for this server?

Allows searching the web via a self-hosted SearXNG instance, returning structured results with title, URL, and snippet.

How do I use searxng-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@searxng-mcp search the web for latest climate change research" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

searxng-mcp

searxng-mcp

Setup

1. Set environment variable

2. Run

Client configuration

Claude Code

Codex

Cursor / VS Code

Claude Desktop

LiteLLM / Anthropic

Tool

Requirements

Maintenance

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API