MCP-searxng

MCP-searxng

MCP server bridging agentic systems with SearXNG web search

107
Stars
19
Forks
107
Watchers
1
Issues
MCP-searxng enables agentic systems to interface with web search engines via the SearXNG platform by implementing the Model Context Protocol. It supports both command-line and local server deployment, providing flexible integration options. Users can configure custom SearXNG server URLs and connect through clients like uvx or claude desktop. The tool simplifies access to structured web search within agentic workflows.

Key Features

Implements Model Context Protocol (MCP) server
Integrates SearXNG web search with agentic systems
Supports deployment via uvx and direct execution
Customizable SearXNG URL via environment variable
Provides structured prompt templates for search
Compatible with clients like claude desktop
Flexible JSON configuration for server setup
Enables local or remote server operation
Easy process management for development
Simple search tool interface

Use Cases

Enabling agentic AI applications to perform web searches
Integrating SearXNG search capabilities into automation workflows
Providing real-time information retrieval for conversational agents
Customizing search endpoints for privacy or proprietary use cases
Enhancing research assistants with structured web search
Experimenting with new agentic models using live web data
Simplifying agent search tool development with prompt templates
Offering SearXNG-powered search as a service to other MCP clients
Local testing of search functionality in agentic frameworks
Facilitating heterogeneous search toolchains in multi-agent environments

README

MCP-searxng

An MCP server for connecting agentic systems to search systems via searXNG.

Tools

Search the web with SearXNG

Prompts

python
search(query: str) -> f"Searching for {query} using searXNG"

Usage

via uvx

  1. configure your client JSON like
json
{
  "mcpServers": {
    "searxng": {
      "command": "uvx", 
      "args": [
        "mcp-searxng"
      ]
    }
  }
}

via git clone

  1. Add the server to claude desktop (the entrypoint is main.py)

Clone the repo and add this JSON to claude desktop

you can run this server with uvx mcp-searxng, or use a local copy of the repo

json
{
  "mcpServers": {
    "searxng": {
      "command": "uv", 
      "args": [
        "--project",
        "/absoloute/path/to/MCP-searxng/",
        "run",
        "/absoloute/path/to/MCP-searxng/mcp-searxng/main.py"
      ]
    }
  }
}

you will need to change the paths to match your environment

Custom SearXNG URL

  1. set the environment variable SEARXNG_URL to the URL of the searxng server (default is http://localhost:8080)

  2. run your MCP client and you should be able to search the web with searxng

Note: if you are using claude desktop make sure to kill the process (task manager or equivalent) before running the server again

Star History

Star History Chart

Repository Owner

Repository Details

Language Python
Default Branch master
Size 38 KB
Contributors 3
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
97.28%
Dockerfile
2.72%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • tavily-search MCP server

    tavily-search MCP server

    A search server that integrates Tavily API with Model Context Protocol tools.

    tavily-search MCP server provides an MCP-compliant server to perform search queries using the Tavily API. It returns search results in text format, including AI responses, URLs, and result titles. The server is designed for easy integration with clients like Claude Desktop or Cursor and supports both local and Docker-based deployment. It facilitates AI workflows by offering search functionality as part of a standardized protocol interface.

    • 44
    • MCP
    • Tomatio13/mcp-server-tavily
  • AgentQL MCP Server

    AgentQL MCP Server

    MCP-compliant server for structured web data extraction using AgentQL.

    AgentQL MCP Server acts as a Model Context Protocol (MCP) server that leverages AgentQL's data extraction capabilities to fetch structured information from web pages. It allows integration with applications supporting MCP, such as Claude Desktop, VS Code, and Cursor, by providing an accessible interface for extracting structured data based on user-defined prompts. With configurable API key support and streamlined installation, it simplifies the process of connecting web data extraction workflows to AI tools.

    • 120
    • MCP
    • tinyfish-io/agentql-mcp
  • mcp-recon

    mcp-recon

    Conversational reconnaissance interface and MCP server for HTTP and ASN analysis.

    mcp-recon acts as a conversational interface and Model Context Protocol (MCP) server, enabling seamless web domain and ASN reconnaissance through natural language prompts. It integrates powerful tooling like httpx and asnmap to conduct lightweight or full HTTP analysis and ASN lookups, exposing these capabilities to any MCP-compatible AI assistant. With predefined prompts and Docker-based deployment, it streamlines infrastructure analysis via AI interfaces such as Claude Desktop.

    • 22
    • MCP
    • nickpending/mcp-recon
  • Maigret MCP Server

    Maigret MCP Server

    OSINT username and URL search server for the Model Context Protocol.

    Maigret MCP Server provides Model Context Protocol (MCP) integration for the Maigret OSINT tool, enabling AI and context-aware applications to search for usernames across hundreds of social networks and analyze URLs. Designed for seamless operation with MCP-compatible clients like Claude Desktop, it supports multiple output formats and advanced filtering options. The server can be installed via Docker or npm, offers Docker-based deployment for consistent performance, and facilitates responsible OSINT research.

    • 205
    • MCP
    • BurtTheCoder/mcp-maigret
  • CVE-Search MCP Server

    CVE-Search MCP Server

    MCP server for querying and managing CVE-Search vulnerability data.

    CVE-Search MCP Server implements the Model Context Protocol to provide structured access to the CVE-Search API. It enables querying vendors, products, and vulnerabilities, as well as retrieving detailed information for specific CVEs. The server facilitates model context integration via MCP client tools, supporting seamless interactions for vulnerability data management.

    • 67
    • MCP
    • roadwy/cve-search_mcp
  • Vectorize MCP Server

    Vectorize MCP Server

    MCP server for advanced vector retrieval and text extraction with Vectorize integration.

    Vectorize MCP Server is an implementation of the Model Context Protocol (MCP) that integrates with the Vectorize platform to enable advanced vector retrieval and text extraction. It supports seamless installation and integration within development environments such as VS Code. The server is configurable through environment variables or JSON configuration files and is suitable for use in collaborative and individual workflows requiring vector-based context management for models.

    • 97
    • MCP
    • vectorize-io/vectorize-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results