Repository navigation
Releases
Releases · designcomputer/searxng-mcp-bridge
v0.1.0-beta.1
First beta of searxng-mcp-bridge — a minimal MCP server that exposes a private SearXNG instance as a search tool over streamable-HTTP, for use as a web-search tool in the llama.cpp WebUI (or any streamable-HTTP / SSE MCP client).
Highlights
- One-file FastMCP server (
server.py), two dependencies (fastmcp,httpx). search(query, max_results, categories, language, time_range)tool returning{title, url, content, engine}from SearXNG's JSON API.- Serves streamable-HTTP (
/mcp), the transport the browser-based WebUI requires. - systemd unit + idempotent
install.sh(creates venv, rewrites unit paths/user, enables the service).
Tested clients
Speaks standard MCP over streamable-HTTP, so it should work with any client supporting that transport. Confirmed working with:
- llama.cpp WebUI — add under MCP Servers as a Streamable HTTP server at
http://<host>:8000/mcp. - Page Assist (browser extension) — works well; point it at the same URL.
Requirements
- A reachable SearXNG instance with the JSON format enabled (
search.formatsincludesjson). - A tool-capable model served with
--jinja.
Status
Beta: working and in use, but the API/config may still change before 1.0. Feedback welcome.
See the README for setup and WebUI wiring.