SearXNG MCP Server logo

SearXNG MCP Server

by tisDDM

The SearXNG MCP Server enables AI assistants to perform web searches using SearXNG, a privacy-respecting metasearch engine. It works out-of-the-box with zero additional deployment by automatically selecting a random instance from SearX.space, while also supporting private instances with basic authentication.

View on GitHub

Last updated: N/A

What is SearXNG MCP Server?

A Model Context Protocol (MCP) server that allows AI assistants to perform web searches using the SearXNG metasearch engine. It simplifies integration by providing a standardized interface for AI agents to access SearXNG's search capabilities.

How to use SearXNG MCP Server?

Install the server from source using npm. Configure the server using environment variables for SearXNG URL, username, and password (if using a private instance). Run the server and integrate it with AI assistants like Claude Desktop, Claude in VSCode, or Smolagents by configuring the MCP server settings.

Key features of SearXNG MCP Server

  • Zero-configuration setup using public SearXNG instances

  • Support for private SearXNG instances with basic authentication

  • Customizable search parameters

  • Privacy-focused search results

Use cases of SearXNG MCP Server

  • Enabling AI assistants to perform web research

  • Integrating search capabilities into AI agents

  • Creating privacy-respecting search tools for AI applications

  • Automating web search tasks with AI

FAQ from SearXNG MCP Server

What is SearXNG?

SearXNG is a privacy-respecting metasearch engine that aggregates results from various search engines while protecting user privacy.

Do I need my own SearXNG instance?

No, the server can automatically use a random public instance from SearX.space. However, for more control and reliability, you can connect to your own SearXNG instance.

How do I configure the server to use my private SearXNG instance?

Set the SEARXNG_URL, SEARXNG_USERNAME, and SEARXNG_PASSWORD environment variables to your instance's URL and credentials.

What parameters can I customize for web searches?

You can customize the query, language, time range, categories, engines, safe search level, page number, and maximum number of results.

How can I integrate this server with Smolagents?

Use the ToolCollection.from_mcp method to create a tool collection from the MCP server and then initialize your agent with those tools.