Skip to main content
Glama
deenesjakoruzh
stormlightlabs

xngmcp

Official
by stormlightlabs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Hybrid

xngmcp

xngmcp gives MCP clients and the terminal two local-web tools: web_search via SearXNG and web_fetch for readable public pages.

Install

Requires Rust 1.85 or newer. Docker with the Compose plugin is required for the included SearXNG backend.

From a source checkout, install xngmcp and start the backend:

cargo install --path .

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

The backend listens on http://127.0.0.1:8080. Confirm it and the CLI work:

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

See the SearXNG guide for configuration, operations, and its integration test. See shell integration to install the generated man pages and shell completions.

Related MCP server: web-basics-mcp

Pi

Install and configure the Pi package with its setup guide. It configures pi-mcp-adapter to run xngmcp serve and exposes web_search and web_fetch as direct Pi tools.

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

Configure an MCP client to start xngmcp serve with SEARXNG_URL=http://127.0.0.1:8080. The server exposes web_search and web_fetch. Use --searxng-url or SEARXNG_URL to select another endpoint.

search --json and fetch --json write a single JSON value to stdout. Errors and diagnostics go to stderr. Run xngmcp --help for all commands and options.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • web-mcp-server

    RyanDam
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server that exposes web_search and web_fetch tools, allowing LLM applications to search the web via DuckDuckGo and fetch page content as cleaned markdown.
    -

  • web-basics-mcp

    yoloyash
    A
    license
    A
    quality
    A
    maintenance
    A self-hosted MCP server providing web search and URL fetching tools, running locally without external API keys or accounts.
    2
    81 npm
    MIT

  • searxng-mcp

    fighter3005
    F
    license
    A
    quality
    C
    maintenance
    MCP server that provides a search_web tool to query a self-hosted SearXNG instance and return structured web search results.
    1
    -

  • Basic MCP Tools

    Tyguy047
    F
    license
    Not graded
    quality
    B
    maintenance
    A self-hosted MCP server providing private web search, web page fetching, and current date/time tools, powered by a bundled SearXNG instance for API-key-free local search.
    2
    -