searxng-mcp-server

ngc-shj/searxng-mcp-server

3.2

If you are the rightful owner of searxng-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The SearXNG MCP Server acts as a bridge to utilize SearXNG as a Model Context Protocol (MCP) server from Claude Code, enabling web, image, and news searches.

Tools
3
Resources
0
Prompts
0

SearXNG MCP Server

A bridge to use SearXNG as an MCP server from Claude Code.

Features

  • searxng_search: Web search with multiple engines
  • searxng_images: Image search
  • searxng_news: News search

Prerequisites

  1. SearXNG instance running

    # Using Docker (recommended)
docker run -d -p 8080:8080 searxng/searxng

# Or install locally
# See: https://docs.searxng.org/admin/installation.html

  2. Verify SearXNG is running

    curl "http://localhost:8080/search?q=test&format=json"

Installation

cd searxng-mcp-server
npm install
npm run build

Claude Code Configuration

Method 1: Using CLI (Recommended)

# Add to local scope (current project)
claude mcp add --transport stdio searxng -- node /path/to/searxng-mcp-server/dist/index.js

# Add to user scope (all projects)
claude mcp add --transport stdio searxng --scope user -- node /path/to/searxng-mcp-server/dist/index.js

To add environment variables:

claude mcp add --transport stdio searxng \
  --env SEARXNG_BASE_URL=http://localhost:8080 \
  -- node /path/to/searxng-mcp-server/dist/index.js

Method 2: Manual Configuration

Project scope (.mcp.json in project root):

{
  "mcpServers": {
    "searxng": {
      "command": "node",
      "args": ["/path/to/searxng-mcp-server/dist/index.js"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

User scope (~/.claude.json):

{
  "mcpServers": {
    "searxng": {
      "command": "node",
      "args": ["/path/to/searxng-mcp-server/dist/index.js"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Verify Installation

# List configured MCP servers
claude mcp list

# Inside Claude Code
/mcp

Auto-approve Tool Calls (Optional)

By default, Claude Code asks for confirmation each time a SearXNG tool is called. To skip confirmations, add the following to ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__searxng__searxng_search",
      "mcp__searxng__searxng_images",
      "mcp__searxng__searxng_news"
    ]
  }
}

Environment Variables

VariableDefaultDescription
SEARXNG_BASE_URLhttp://localhost:8080SearXNG server URL

Usage Examples

From Claude Code:

Web Search

Search for "Rust programming language features" using SearXNG

Image Search

Find images of "Mount Fuji" using SearXNG

News Search

Get latest news about "AI developments" using SearXNG

Troubleshooting

Cannot connect to SearXNG

# Check if SearXNG is running
curl "http://localhost:8080/search?q=test&format=json"

# If not running (Docker)
docker run -d -p 8080:8080 searxng/searxng

No results returned

SearXNG aggregates results from multiple search engines. If no results are returned:

  1. Check if your SearXNG instance has engines enabled
  2. Try specifying engines: engines: "google,bing,duckduckgo"
  3. Check SearXNG logs for errors

MCP server not showing up

# Verify server is registered
claude mcp list

# Check server health
claude mcp get searxng

License

MIT