Skip to main content
Glama
caikiji

@caikiji/mcp-search

by caikiji

✨ Features

  • 🌐 Web search — aggregates results from multiple engines (Brave, DuckDuckGo, Bing News, etc.)

  • 📄 Page fetch — read full page content from search results as Markdown

  • 🔍 Engine discoveryinfo to see engine counts; info scope: "engines" to list all

  • 🎯 Token efficient — compact mode, smart snippet truncation, deduplicated results

  • 🔒 Self-hosted — works with your own SearXNG instance, full privacy control

Related MCP server: searxng-mcp

Installation

npm install -g @caikiji/mcp-search

Configuration

Environment variables

Variable

Default

Description

SEARCH_URL

Your SearXNG instance URL (required)

SEARCH_AUTH

Basic auth credentials (user:pass). Leave empty if your instance is public.

SEARCH_TIMEOUT

15000

SearXNG API timeout (ms)

SEARCH_FETCH_TIMEOUT

15000

Page fetch timeout (ms)

SEARCH_DEFAULT_COUNT

10

Default results per search (1–50)

SEARCH_MAX_LENGTH

8000

Max chars for result content (500–50000)

SEARCH_SNIPPET_LENGTH

300

Max chars for result snippet (truncated at word boundary)

SEARCH_FETCH_UA

Chrome UA

User-Agent for page fetching

SEARCH_RECOMMENDED_ENGINES

Semicolon-separated recommended engines, optionally with engine|description. Shown in info output. See config example below.

MCP Client config

{
  "mcpServers": {
    "search": {
      "command": "npx",
      "args": ["-y", "@caikiji/mcp-search"],
      "env": {
        "SEARCH_URL": "https://search.example.com",
        "SEARCH_AUTH": "user:password",
        "SEARCH_RECOMMENDED_ENGINES": "duckduckgo|general purpose, privacy;bing|images, news;sogou|Chinese web;sogou wechat|WeChat articles;stackoverflow|programming Q&A;github|code repositories"
      }
    }
  }
}

Tools

Tool

Arguments

Description

query

query, [language], [categories], [time_range], [engines], [pageno], [count], [format]

Web search with dedup, snippet, and source info. format: "compact" for minimal token usage.

result

url, [max_length]

Fetch a URL from results and return as Markdown. Works on most blogs/docs sites.

info

[scope]

Instance info. Default: counts, categories, settings. scope: "engines" for full list with categories.

query parameters

Param

Description

query

Search query (required)

site

Restrict to domain, e.g. github.com. Prepends site: to the query.

language

Language code (zh-CN, en-US, auto). Default: auto

categories

Comma-separated: general, news, images, video, music, it, science, files, social media

time_range

day, week, month, year

engines

Comma-separated engine names. Use info to see available ones

pageno

Page number. Default: 1

count

Results to return (1–50). Default: 10

format

full (title+URL+snippet) or compact (title+URL only, minimal tokens). Default: full

depth

When true, forces count=1 and fetches the top result's full content via reader mode. Saves the query→pick→fetch round trip. Default: false

Output format

Full mode:

5 results | Sources: duckduckgo,brave
[1] Title
URL: https://...
Src: duckduckgo

Snippet text here (truncated to 300 chars)...

[2] Next Title
URL: https://...
Src: google +2

Compact mode:

5 results | Sources: duckduckgo
[1] Title — https://...
[2] Next Title — https://...

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    MCP server for private web search via self-hosted SearXNG with local reranking, full-page content fetching via Firecrawl, and optional Ollama-powered query expansion and summaries.
    7
    245 npm
    24
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Privacy-focused web search MCP server using SearXNG with Streamable HTTP transport, supporting authentication and advanced search parameters.
    -
  • A
    license
    A
    quality
    D
    maintenance
    A privacy-focused web search and content extraction MCP server. It integrates SearxNG with fallback to Google scraping, featuring relevance ranking, security-aware search, and rate limiting.
    3
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that aggregates web search results from multiple engines and optionally renders pages to Markdown, providing a unified search interface.
    7 npm
    3
    ISC