xngmcp

xngmcp предоставляет MCP-клиентам и терминалу два локальных веб-инструмента: web_search через SearXNG и web_fetch для получения читаемых публичных страниц.

Установка

Требуется Rust 1.85 или новее. Для включённого бэкенда SearXNG необходим Docker с плагином Compose.

Из клонированного исходного кода установите 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-клиент на запуск xngmcp serve с SEARXNG_URL=http://127.0.0.1:8080. Сервер предоставляет web_search и web_fetch. Используйте --searxng-url или SEARXNG_URL, чтобы выбрать другую конечную точку.

search --json и fetch --json записывают одно значение JSON в stdout. Ошибки и диагностика выводятся в stderr. Выполните xngmcp --help, чтобы увидеть все команды и параметры.