mcp-discovery

MCP Discovery is a Rust-based CLI tool that inventories MCP Server capabilities and presents them in the terminal or as generated documentation files. The tool can render output using built-in templates (md, md-plain, html, txt) or custom Handlebars templates, and it can generate or update documentation files with the discovered server details. Use it to inspect a target MCP Server's information, tools, resources, and capabilities, then save that information as Markdown, HTML, or plain text for embedding in README files or project docs. Examples show running the CLI to print capabilities or to create/update files with rendered output, either from built-in templates or a custom template you provide.

Prerequisites:

• A machine with Rust toolchain installed (Rustup, cargo).
• Optional: prebuilt binaries from releases if you prefer not to build from source.

Install from source (via cargo):

1. Install Rust and Cargo: follow https://www.rust-lang.org/tools/install
2. Install the MCP Discovery CLI binary: cargo install mcp-discovery
3. Verify installation: mcp-discovery --version

Alternatively, install using a package manager or download a release binary from the project releases page and place the executable in your PATH. After installation, you can run the CLI with the examples shown in the README.

Tips and notes:

• By default, mcp-discovery will use the print subcommand if no subcommand is provided.
• Use -f to specify an output file when creating or updating documentation, and -t to choose a built-in template (md, md-plain, html, txt).
• You can inject a custom Handlebars template using --template-file or --template-string, and you can embed an inline template inside a render block for update commands.
• When updating existing files, the tool will insert content between the mcp-discovery-render markers to keep documentation current.
• The command examples typically show using npx to fetch a server package; adapt the command according to how you deploy or integrate MCP servers in your environment.