# mcp-searxng

> MCP Server

This repository provides an MCP server implementation that integrates the SearxNG API, enabling web search capabilities with features like general queries, news, and pagination control. This repository provides an MCP

## Overview

- **Category:** Search & Knowledge
- **Language:** JavaScript
- **Stars:** 1147
- **Forks:** 7
- **Owner:** ihor-sokoliuk
- **GitHub:** https://github.com/ihor-sokoliuk/mcp-searxng
- **Created:** 2024-12-23T02:00:51+00:00
- **Updated:** 2025-03-25T09:32:36+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-server-searxng-web-search-api

## Setup

## Setup

### Setting the SEARXNG_URL

1.  Choose a SearxNG instance from the [list of public instances](https://searx.space/) or use your local environment.
2.  Set the `SEARXNG_URL` environment variable to the instance URL.
3.  The default `SEARXNG_URL` value is `http://localhost:8080`.

### Usage with Claude Desktop

### Installing via Smithery

To install SearxNG Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ihor-sokoliuk/server-searxng):

```bash
npx -y @smithery/cli install @ihor-sokoliuk/server-searxng --client claude
```

### NPX

```json
{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y"
        "<full path to mcp-searxng repo>/"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
```

### Docker

#### Build

```bash
docker build -t mcp-server-searxng:latest -f Dockerfile .
```

#### Use

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "searxng": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEARXNG_URL",
        "mcp-server-searxng:latest"
      ],
      "env": {
        "SEARXNG_URL": "YOUR_SEARXNG_INSTANCE_URL"
      }
    }
  }
}
```

## Tools

## Available Tools

		1. Web Search (General queries, news, articles, with pagination)
		2. Pagination (Control return size and result counts options)
		3. searxng_web_search (Execute web searches with pagination)