SearXNG

SearXNG

An MCP server provide web searching via SearXNG & retrieve url as makrdown.

7
Stars
5
Forks
0
Releases

Overview

An SSE-based MCP server example designed to let an AI Agent search for external information through SearXNG's open-source meta-search engine and retrieve results as Markdown. The server runs with uv to manage dependencies and the Python runtime, and connects to a SearXNG instance via a configurable SEARXNG_URL. It integrates Microsoft's markdownify to extract web pages into Markdown-formatted text for downstream processing. The project includes a pre-configured SearXNG setup under searxng-docker to facilitate testing, with a docker-compose.yaml and searxng settings. The MCP server exposes tools via MCP Inspector (web_search and web_url_read) and can be run as an SSE service on port 5488 by default. Startup parameters include host, port, and searxng_url, enabling flexible deployment. The README provides instructions for starting the SearXNG service, starting the MCP server via uv run server.py, or via Docker, and for verifying results using the MCP Inspector app. This makes it suitable for cloud-native, decoupled AI workflows.

Details

Owner
erhwenkuo
Language
Python
License
MIT License
Updated
2025-12-07

Features

SSE-based MCP server

Exposes the MCP server via Server-Sent Events (SSE) for remote, decoupled client connections.

SearXNG meta-search integration

Connects to a SearXNG instance to perform multi-engine searches through a unified interface.

Markdown extraction with Markdownify

Uses Microsoft's markdownify to convert retrieved web pages into Markdown-formatted text for agent consumption.

MCP Inspector compatibility

Designed to be used with the MCP Inspector for testing, with a workflow featuring tools like web_search and web_url_read.

Pre-configured SearXNG test setup

Includes a ready-to-use SearXNG setup (searxng-docker) to simplify testing.

Docker deployment guidance

Provides Docker-based deployment guidance, including building the image and running with SEARXNG_URL.

Configurable runtime parameters

Offers CLI options to configure host, port, and SEARXNG URL at startup.

Audience

AI AgentTo search for external information via SearXNG using the MCP server.
Developers/IntegratorsTo learn MCP integration and deploy SSE-based search workflows.
MCP InspectorsTo connect and test the MCP server with the Inspector tool.

Tags

SSEMCPSearXNGMarkdownifyweb_searchweb_url_readAI agentMCP InspectorDockeruvself-hostedopen-sourcemeta-searchmarkdown