xngmcp

xngmcp 为 MCP 客户端和终端提供两个本地 Web 工具：web_search 通过 SearXNG，以及 web_fetch 用于可读的公共页面。

Install

需要 Rust 1.85 或更高版本。需要带有 Compose 插件的 Docker，才能使用随附的 SearXNG 后端。

从源代码检出中安装 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 指南 了解配置、操作， 及其集成测试。参见 shell 集成 以 安装生成的 man 页面和 shell 补全。

Related MCP server: web-basics-mcp

Pi

安装并配置 Pi 包，使用其 设置指南。它会配置 pi-mcp-adapter 以运行 xngmcp serve，并将 web_search 和 web_fetch 暴露 为直接的 Pi 工具。

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

配置 MCP 客户端以 SEARXNG_URL=http://127.0.0.1:8080 启动 xngmcp serve。服务器暴露 web_search 和 web_fetch。使用 --searxng-url 或 SEARXNG_URL 选择其他端点。

search --json 和 fetch --json 向 stdout 写入单个 JSON 值。错误 和诊断信息输出到 stderr。运行 xngmcp --help 查看所有命令和选项。