Skip to main content
Glama
franktheglock

SearXNG MCP Server

SearXNG MCP Server

A Model Context Protocol (MCP) server that provides web search capabilities using SearXNG.

Features

  • 🔍 Web search using your SearXNG instance

  • 🎯 Category filtering (general, news, images, videos, science, etc.)

  • 🌍 Multi-language support

  • ⏰ Time range filtering

  • 🛡️ Safe search options

  • 📊 Formatted results with titles, URLs, snippets, and metadata

Related MCP server: SearXNG MCP Server

Quick Start

Prerequisites

  • Node.js 18 or higher

  • A running SearXNG instance

  • ngrok (for public sharing)

Installation

npm install

Configuration

The server uses the SearXNG instance at http://192.168.1.44:55001 by default. You can override this with the SEARXNG_URL environment variable:

export SEARXNG_URL=http://your-searxng-instance:port

Running Locally

npm start

Sharing Publicly with ngrok

  1. Install ngrok if you haven't already:

    npm install -g ngrok
  2. Start the MCP server:

    npm start
  3. In another terminal, expose it via ngrok:

    ngrok http 3000
  4. Use the ngrok URL in your MCP client configuration

Usage in LM Studio

For Local Use

Add this to your LM Studio MCP settings:

{
  "mcpServers": {
    "searxng": {
      "command": "node",
      "args": ["C:\\Users\\claym\\Desktop\\public mcp\\index.js"],
      "env": {
        "SEARXNG_URL": "http://192.168.1.44:55001"
      }
    }
  }
}

For Public/Shared Use (via ngrok)

When sharing with others, they can use this configuration:

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": ["-y", "searxng-mcp-server@latest"]
    }
  }
}

Note: For the npx version to work, you'll need to publish this to npm first.

Available Tools

Search the web using SearXNG.

Parameters:

  • query (required): The search query

  • categories (optional): Search categories - "general", "news", "images", "videos", "science", etc. Default: "general"

  • language (optional): Language code like "en", "es", "fr". Default: "en"

  • time_range (optional): Filter by time - "day", "week", "month", "year". Default: all time

  • safesearch (optional): Safe search level - 0 (off), 1 (moderate), 2 (strict). Default: 0

Example:

Search for "latest AI news" in the news category from the past week

Development

Project Structure

.
├── index.js          # Main MCP server implementation
├── package.json      # Dependencies and scripts
└── README.md         # This file

Testing

You can test the server using any MCP-compatible client like:

  • LM Studio

  • Claude Desktop

  • Other MCP clients

Troubleshooting

Connection Issues

If you can't connect to SearXNG:

  1. Verify your SearXNG instance is running: curl http://192.168.1.44:55001

  2. Check firewall settings

  3. Ensure the URL is correct in the configuration

No Results

If searches return no results:

  1. Test the same query directly in SearXNG web interface

  2. Try different categories or remove filters

  3. Check SearXNG logs for errors

License

MIT

Available Tools

1 tool

TDQS

A3.9/5.0
Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'web_search' follows a clear verb_noun pattern.

Tool Count2/5

A single tool for a web search server feels thin and limited in scope. While it covers the core search functionality, it lacks additional features like filtering, advanced queries, or result management that might be expected in a more complete search interface.

Completeness2/5

The server provides only basic search functionality without any supporting operations. There are significant gaps, such as no ability to refine searches, handle pagination, or access search history, making the surface incomplete for robust web search tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Enables privacy-respecting web searches through SearXNG metasearch engine with customizable parameters like language, time range, categories, and engines. Supports safe search levels, pagination control, and basic authentication for secure search operations.
    1
    2
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to perform privacy-respecting web searches through SearXNG, with support for multiple search engines, categories, and advanced filtering options.
    25
  • A
    license
    A
    quality
    D
    maintenance
    Enables web search, image search, and news search through a self-hosted SearXNG instance. Provides privacy-focused meta-search capabilities aggregating results from multiple search engines.
    3
    1
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables privacy-respecting web, image, video, and news searches through SearxNG metasearch engine, with options for URL fetching and time filtering.
    5

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/franktheglock/public-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server