SearXNG MCP Server

This repository provides an MCP server implementation that leverages the SearxNG API to enable web search functionality within MCP-compatible applications.

Features

• Web Search: Supports general queries, news, and articles with pagination.
• Pagination: Allows control over the number of results returned per page and the starting offset.

Tools

• searxng_web_search: Executes web searches with pagination.
  • Inputs:
    • query (string): Search terms.
    • count (number, optional): Results per page (default 20).
    • offset (number, optional): Pagination offset (default 0).

Configuration

To configure the server, set the SEARXNG_URL environment variable to a SearxNG instance URL (default: http://localhost:8080). A list of public instances is available here.

Usage with Claude Desktop

Installation options include Smithery, NPX, and Docker. Smithery provides automated installation. NPX and Docker configurations are provided for manual setup, requiring updates to the claude_desktop_config.json file with the appropriate command and environment variables, including the SEARXNG_URL.

License

Licensed under the MIT License.