xngmcp

xngmcp는 MCP 클라이언트와 터미널에 두 가지 로컬 웹 도구를 제공합니다: SearXNG를 통한 web_search와 읽을 수 있는 공개 페이지를 위한 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 가이드를 참조하세요. 생성된 매뉴얼 페이지와 셸 완성을 설치하려면 셸 통합을 참조하세요.

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를 실행하세요.