xngmcp

xngmcp bietet MCP-Clients und dem Terminal zwei lokale Web-Tools: web_search über SearXNG und web_fetch für lesbare öffentliche Seiten.

Installation

Erfordert Rust 1.85 oder neuer. Docker mit dem Compose-Plugin ist für das enthaltene SearXNG-Backend erforderlich.

Installieren Sie xngmcp aus einem Quell-Checkout und starten Sie das Backend:

cargo install --path .

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

Das Backend lauscht auf http://127.0.0.1:8080. Bestätigen Sie, dass es und die CLI funktionieren:

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

Siehe den SearXNG-Leitfaden für Konfiguration, Betrieb und den Integrationstest. Siehe Shell-Integration, um die generierten Manpages und Shell-Vervollständigungen zu installieren.

Related MCP server: web-basics-mcp

Pi

Installieren und konfigurieren Sie das Pi-Paket mit seinem Setup-Leitfaden. Es konfiguriert pi-mcp-adapter so, dass xngmcp serve ausgeführt wird, und stellt web_search und web_fetch als direkte Pi-Tools bereit.

Verwendung

# 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

Konfigurieren Sie einen MCP-Client, um xngmcp serve mit SEARXNG_URL=http://127.0.0.1:8080 zu starten. Der Server stellt web_search und web_fetch bereit. Verwenden Sie --searxng-url oder SEARXNG_URL, um einen anderen Endpunkt auszuwählen.

search --json und fetch --json schreiben einen einzelnen JSON-Wert nach stdout. Fehler und Diagnosen gehen nach stderr. Führen Sie xngmcp --help aus, um alle Befehle und Optionen anzuzeigen.