SearXNG

Bridges SearXNG searches (web, image, news) to Claude Code via an MCP server.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can connect Claude Code to a SearXNG instance by running a specialized MCP server that bridges SearXNG search capabilities to Claude Code. This allows you to perform web, image, and news searches through a unified, conversation-friendly interface while keeping your SearXNG setup as the source of results.

How to use

Use the MCP server from Claude Code by adding it as an MCP transport. Once configured, you can issue web, image, and news search prompts that are translated to SearXNG queries. The results are returned in a structured format suitable for follow-up questions, comparisons, or aggregations within your chats.

How to install

Prerequisites include a running SearXNG instance exposing a JSON API and a Node.js environment to run the MCP server.

Install the MCP server and build the project:

cd searxng-mcp-server
npm install
npm run build

Configuration and usage notes

To bridge to SearXNG, you must run SearXNG with JSON format enabled and provide Claude Code with the base URL via an environment variable.

Environment variable used by the MCP server:

SEARXNG_BASE_URL=http://localhost:8080

MCP configuration for Claude Code

You configure the MCP server in Claude Code to run the local Node.js bridge. The following configuration runs the built server from its dist index file and exposes the SearXNG base URL via an environment variable.

Troubleshooting and tips

If you cannot connect, verify that your SearXNG instance is running and JSON format is enabled, then ensure the MCP process has access to the correct SEARXNG_BASE_URL.

Common issues include JSON format not enabled or the MCP process failing to locate the dist/index.js file. Double-check the path you supply in the command and the environment variable used by the server.

Available tools

searxng_search

Performs web searches across multiple engines via SearXNG and returns aggregated results.

searxng_images

Fetches image search results from SearXNG for a given query.

searxng_news

Retrieves the latest news results from SearXNG for a specified topic.