xngmcp

xngmcp は、MCP クライアントとターミナルに 2 つのローカル Web ツールを提供します：web_search（SearXNG 経由）と web_fetch（読みやすい公開ページ用）。

インストール

Rust 1.85 以降が必要です。同梱の SearXNG バックエンドには、Compose プラグインを備えた Docker が必要です。

ソースのチェックアウトから、xngmcp をインストールしてバックエンドを起動します：

cargo install --path .

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

バックエンドは http://127.0.0.1:8080 で待ち受けます。これと CLI が動作することを確認してください：

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

設定、運用、統合テストについては SearXNG ガイド を参照してください。生成された man ページとシェル補完をインストールするには シェル連携 を参照してください。

Related MCP server: web-basics-mcp

Pi

Pi パッケージのインストールと設定は、セットアップガイド に従ってください。これにより pi-mcp-adapter が xngmcp serve を実行するように設定され、web_search と web_fetch が Pi の直接ツールとして公開されます。

使用方法

# 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

MCP クライアントを設定して、SEARXNG_URL=http://127.0.0.1:8080 で xngmcp serve を起動してください。サーバーは web_search と web_fetch を公開します。別のエンドポイントを選択するには、--searxng-url または SEARXNG_URL を使用します。

search --json と fetch --json は、単一の JSON 値を stdout に書き込みます。エラーと診断情報は stderr に出力されます。すべてのコマンドとオプションについては xngmcp --help を実行してください。