Skip to content

Releases

v0.1.0-beta.1

Choose a tag to compare

@designcomputer designcomputer released this 21 Jun 20:43

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.formats includes json).
  • 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.