@the-bao/searxng-mcp

v1.0.2

Published

2 months ago

MCP server for SearXNG metasearch engine — lets AI tools search the web

0High
0Medium
0Low

the-bao

mcp searxng search metasearch ai claude model-context-protocol

SearXNG MCP Server

An MCP (Model Context Protocol) server that lets AI tools search the web via your SearXNG instance.

Prerequisites

Node.js >= 18
A running SearXNG instance with JSON format enabled in settings.yml:

search:
  formats:
    - html
    - json   # Required for this MCP server

Quick Start

Install via Claude Code

# Global (recommended, works in all projects)
claude mcp add searxng -s user -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

# Project-level only
claude mcp add searxng -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

Manual

SEARXNG_BASE_URL=http://localhost:8080 npx -y @the-bao/searxng-mcp

Configuration

Environment Variable

| Variable | Required | Description | |----------|----------|-------------| | SEARXNG_BASE_URL | Yes | Your SearXNG instance URL (e.g. http://localhost:8080, https://search.example.com) |

MCP Client Setup

Add to your MCP client configuration. Examples for common clients:

Claude Code

# Global (recommended, works in all projects)
claude mcp add searxng -s user -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

# Project-level only
claude mcp add searxng -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Cline / Roo Code (`.vscode/mcp.json`)

{
  "servers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Cursor (`.cursor/mcp.json`)

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Tools

`searxng_search`

Search the web via SearXNG, aggregating results from Google, Bing, DuckDuckGo, Wikipedia, and 70+ other engines.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | query | string | required | Search query (supports site:, filetype:, etc.) | | categories | string | — | Filter: general, news, images, videos, science, it, files, music, repos, packages | | engines | string | — | Specific engines: google, bing, duckduckgo, wikipedia, github, stackoverflow, arxiv, pubmed, youtube... | | language | string | — | Language code: en, zh, ja, de, fr, es... | | pageno | number | 1 | Page number (1-50) | | time_range | string | — | day, month, or year | | safesearch | number | 0 | 0=off, 1=moderate, 2=strict | | response_format | string | markdown | markdown or json |

Examples:

searxng_search(query="Rust programming tutorial")
searxng_search(query="AI", categories="news", time_range="day")
searxng_search(query="MCP server", engines="github")
searxng_search(query="transformer attention", categories="science")

`searxng_autocomplete`

Get search query suggestions.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | query | string | required | Partial search query | | language | string | — | Language code |

Docker Compose (SearXNG)

If you don't have SearXNG running yet:

services:
  searxng:
    image: searxng/searxng:latest
    ports:
      - "8080:8080"
    volumes:
      - ./searxng-settings.yml:/etc/searxng/settings.yml:ro

Make sure searxng-settings.yml has JSON format enabled:

use_default_settings: true

search:
  formats:
    - html
    - json

中文文档

SearXNG MCP 服务器

一个基于 MCP（模型上下文协议）的服务器，让 AI 工具通过你的 SearXNG 实例搜索网页。

前置要求

Node.js >= 18
一个运行中的 SearXNG 实例，并在 settings.yml 中启用 JSON 格式：

search:
  formats:
    - html
    - json   # 本 MCP 服务器必须启用此项

快速开始

通过 Claude Code 安装

# 全局安装（推荐，所有项目可用）
claude mcp add searxng -s user -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

# 仅当前项目
claude mcp add searxng -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

手动运行

SEARXNG_BASE_URL=http://localhost:8080 npx -y @the-bao/searxng-mcp

配置

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | SEARXNG_BASE_URL | 是 | SearXNG 实例地址（如 http://localhost:8080、https://search.example.com） |

MCP 客户端配置

将以下内容添加到你的 MCP 客户端配置中。以下是常见客户端的示例：

Claude Code

# 全局安装（推荐，所有项目可用）
claude mcp add searxng -s user -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

# 仅当前项目
claude mcp add searxng -e SEARXNG_BASE_URL=http://localhost:8080 -- npx -y @the-bao/searxng-mcp

Claude Desktop（`claude_desktop_config.json`）

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Cline / Roo Code（`.vscode/mcp.json`）

{
  "servers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

Cursor（`.cursor/mcp.json`）

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "@the-bao/searxng-mcp"],
      "env": {
        "SEARXNG_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

工具

`searxng_search`

通过 SearXNG 搜索网页，聚合 Google、Bing、DuckDuckGo、Wikipedia 等 70 多个搜索引擎的结果。

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | query | string | 必填 | 搜索关键词（支持 site:、filetype: 等语法） | | categories | string | — | 分类过滤：general、news、images、videos、science、it、files、music、repos、packages | | engines | string | — | 指定引擎：google、bing、duckduckgo、wikipedia、github、stackoverflow、arxiv、pubmed、youtube 等 | | language | string | — | 语言代码：en、zh、ja、de、fr、es 等 | | pageno | number | 1 | 页码（1-50） | | time_range | string | — | 时间范围：day（当天）、month（一个月内）、year（一年内） | | safesearch | number | 0 | 安全搜索：0=关闭、1=适中、2=严格 | | response_format | string | markdown | 输出格式：markdown 或 json |

示例：

searxng_search(query="Rust 编程教程")
searxng_search(query="AI", categories="news", time_range="day")       # 搜索今日 AI 新闻
searxng_search(query="MCP server", engines="github")                  # 只搜索 GitHub
searxng_search(query="transformer attention", categories="science")   # 搜索学术论文

`searxng_autocomplete`

获取搜索关键词建议。

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | query | string | 必填 | 部分搜索关键词 | | language | string | — | 语言代码 |

Docker Compose（SearXNG）

如果你还没有部署 SearXNG：

services:
  searxng:
    image: searxng/searxng:latest
    ports:
      - "8080:8080"
    volumes:
      - ./searxng-settings.yml:/etc/searxng/settings.yml:ro

确保 searxng-settings.yml 启用了 JSON 格式：

use_default_settings: true

search:
  formats:
    - html
    - json

许可证

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

SearXNG MCP Server

Prerequisites

Quick Start

Install via Claude Code

Manual

Configuration

Environment Variable

MCP Client Setup

Claude Code

Claude Desktop (claude_desktop_config.json)

Cline / Roo Code (.vscode/mcp.json)

Cursor (.cursor/mcp.json)

Tools

searxng_search

searxng_autocomplete

Docker Compose (SearXNG)

中文文档

SearXNG MCP 服务器

前置要求

快速开始

通过 Claude Code 安装

手动运行

配置

环境变量

MCP 客户端配置

Claude Code

Claude Desktop（claude_desktop_config.json）

Cline / Roo Code（.vscode/mcp.json）

Cursor（.cursor/mcp.json）

工具

searxng_search

searxng_autocomplete

Docker Compose（SearXNG）

许可证

Claude Desktop (`claude_desktop_config.json`)

Cline / Roo Code (`.vscode/mcp.json`)

Cursor (`.cursor/mcp.json`)

`searxng_search`

`searxng_autocomplete`

Claude Desktop（`claude_desktop_config.json`）

Cline / Roo Code（`.vscode/mcp.json`）

Cursor（`.cursor/mcp.json`）

`searxng_search`

`searxng_autocomplete`