xngmcp

xngmcp gives MCP clients and the terminal two local-web tools: web_search via SearXNG and web_fetch for readable public pages.

Install

Requires Rust 1.85 or newer. Docker with the Compose plugin is required for the included SearXNG backend.

From a source checkout, install xngmcp and start the backend:

cargo install --path .

./infra/searxng/bootstrap.sh
docker compose --env-file infra/searxng/.env \
  -f infra/searxng/compose.yaml up -d --wait

The backend listens on http://127.0.0.1:8080. Confirm it and the CLI work:

curl --fail --silent --show-error http://127.0.0.1:8080/healthz >/dev/null
xngmcp search --limit 5 'Rust MCP SDK'

See the SearXNG guide for configuration, operations, and its integration test. See shell integration to install the generated man pages and shell completions.

Related MCP server: web-basics-mcp

Pi

Install and configure the Pi package with its setup guide. It configures pi-mcp-adapter to run xngmcp serve and exposes web_search and web_fetch as direct Pi tools.

Usage

# Search the web
xngmcp search 'Rust MCP SDK'
xngmcp search --json --limit 5 'Rust MCP SDK'

# Fetch readable text or Markdown from a public URL
xngmcp fetch --format text https://doc.rust-lang.org/book/

# Run the stdio MCP server
xngmcp serve

Configure an MCP client to start xngmcp serve with SEARXNG_URL=http://127.0.0.1:8080. The server exposes web_search and web_fetch. Use --searxng-url or SEARXNG_URL to select another endpoint.

search --json and fetch --json write a single JSON value to stdout. Errors and diagnostics go to stderr. Run xngmcp --help for all commands and options.