by rust-mcp-stack
A command-line utility for discovering and documenting MCP Server capabilities, supporting terminal display, file generation in Markdown, HTML, plain text, JSON, and custom Handlebars templates, plus GitHub Action integration.
Mcp Discovery provides a CLI that queries MCP Servers to retrieve their tools, resources, and capabilities, then formats the data for human consumption or documentation purposes.
print
subcommand to view capabilities in the terminal:
mcp-discovery -- npx -y @modelcontextprotocol/server-everything
create
subcommand:
mcp-discovery create -f capabilities.md -- npx -y @modelcontextprotocol/server-everything
update
subcommand.md
, md-plain
, html
, txt
) via -t/--template
or supply a custom Handlebars template using -p/--template-file
or -s/--template-string
.mcp-discovery-action
repository for automated documentation updates.print
(default), create
, and update
for flexible workflows.Q: Do I need a Rust toolchain to use Mcp Discovery? A: Only if you plan to build from source. Pre‑compiled binaries are available for major platforms.
Q: Can I use Mcp Discovery with any MCP Server? A: Yes, as long as the server complies with the Model Context Protocol and is reachable by the CLI.
Q: How does the update
subcommand locate the insertion points?
A: It looks for comment markers mcp-discovery-render
and mcp-discovery-render-end
(or their equivalents in other file types) and replaces the content between them.
Q: What if I need a format not supported out of the box?
A: Supply a custom Handlebars template via --template-file
or --template-string
to define any output structure.
Q: How do I configure the CLI as a GitHub Action?
A: Add the rust-mcp-stack/mcp-discovery-action
to your workflow and specify the target file and template options as action inputs.
A command-line tool written in Rust for discovering and documenting MCP Server capabilities.
It supports outputting the results in the terminal or saving them to files in Markdown, HTML, plain text, JSON, or a custom template defined by you.
Check the project documentation for instructions and command examples.
.md
), HTML (.html
), or plain text (.txt
) formats with MCP Server details and capabilities.md
, md-plain
, html
, txt
) or supply custom Handlebars templates for personalized output.This open-source project leverages the rust-mcp-sdk for seamless interaction with MCP Servers.
🌐 Check out the rust-mcp-filesystem capabilities page for a sample output.
Check the project documentation for instructions on installing the tool on different platforms.
The easiest way to automate and maintain up-to-date MCP Server documentation , is to use mcp-discovery as a GitHub action. Please see rust-mcp-stack/mcp-discovery-action for installation and configuration instructions.
print
: Displays MCP Server capabilities in the terminal.create
: Creates a new file with MCP Server capability details.update
: Updates an existing file by inserting MCP Server capabilities between specified
markers.👉 Note: If no subcommand is provided, the print
subcommand will be used by default.
-f, --filename <FILENAME>
: Used with create
and update
commands to specify the output file to generate or modify.-t, --template <TEMPLATE>
: Choose a built-in output template. Options: md
, md-plain
, html
, txt
.-p, --template-file <TEMPLATE_FILE>
: Path to a custom Handlebars template file.-s, --template-string <TEMPLATE_STRING>
: Inline Handlebars template provided as a string.-h, --help
: Display help information.-V, --version
: Display the version of mcp-discovery
.👉 Note: If no template is provided, mcp-discovery
will automatically select the most suitable built-in template based on the file extension.
The CLI supports the following built-in output templates:
md
: Formatted Markdown that presents MCP Server capabilities in a table format.md-plain
: Minimalist Markdown for straightforward output, using plain text instead of tables.html
: Structured HTML with basic styling.txt
: Plain text for raw, unformatted output.You can provide custom Handlebars templates in different ways:
--template-file
flag to provide a custom template file.--template-string
flag to provide a raw Handlebars template directly as a string.update
command only — this will not function with print or create.Inline templates must be enclosed within designated marker annotations.
Print MCP Server capabilities to the terminal:
mcp-discovery -- npx -y @modelcontextprotocol/server-everything
mcp-discovery create -f capabilities.html -- npx -y @modelcontextprotocol/server-everything
📄 Click here to view generated html file
mcp-discovery create -f capabilities.md -- npx -y @modelcontextprotocol/server-everything
mcp-discovery create -f capabilities.md --template-file=custom_template.hbs -- npx -y @modelcontextprotocol/server-everything
💡 See the Command Examples section in the project documentation for additional CLI usage examples.
When using the update
subcommand, mcp-discovery
places capabilities between designated markers in the target file, which vary by file format and are typically comment lines.
The update command simplifies the process for developers and maintainers to keep documentation current effortlessly.
Run the mcp-discovery update command anytime to refresh the file with the latest MCP Server capabilities.
mcp-discovery-render
mcp-discovery-render-end
👉 The mcp-discovery-render marker supports template and template-file properties as well. Check the examples below for details.
You can optionally include an inline template identifier within the render block, enclosed by:
mcp-discovery-template
mcp-discovery-template-end
If a template annotation is detected within a render block, mcp-discovery
will use it to render the output. This allows for customized templates without depending on built-in or external template files. Check the examples below for details:
# Server Info and Capabilities
<!-- mcp-discovery-render -->
Server Capabilities will be placed here...
<!-- mcp-discovery-render-end -->
# Server Info and Capabilities
<!-- mcp-discovery-render template=md-plain -->
Server Capabilities will be placed here...
<!-- mcp-discovery-render-end -->
# Server Info and Capabilities
<!-- mcp-discovery-render template=my-custom-template.hbs -->
Server Capabilities will be placed here...
<!-- mcp-discovery-render-end -->
<!DOCTYPE html>
<html lang="en">
<head>
<title>My MCP Server</title>
</head>
<body>
<h1>MCP Server Details</h1>
<div>
<!-- mcp-discovery-render -->
<!-- mcp-discovery-render-end -->
</div>
</body>
</html>
<h1>MCP Server Details</h1>
<div>
<!-- mcp-discovery-render -->
<!-- mcp-discovery-template
<b>Name: </b>{{name}}
<br/>
<b>Version: </b>{{version}}
<br/>
<b>Number of tools:</b> {{len tools}}
<h2>Summary:</h2>
{{> html-summary }}
mcp-discovery-template-end -->
<!-- mcp-discovery-render-end -->
</div>
Below is a screenshot showing the resulting HTML after the mcp-discovery update command is executed:
You can execute the mcp-discovery update command whenever you need to refresh the file with the latest MCP Server capabilities.
We welcome everyone who wishes to contribute! Please refer to the contributing guidelines for more details.
All contributions, including issues and pull requests, must follow Rust's Code of Conduct.
Unless explicitly stated otherwise, any contribution you submit for inclusion in mcp-discovery is provided under the terms of the MIT License, without any additional conditions or restrictions.
This project is licensed under the MIT License. see the LICENSE file for details.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "server-everything": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-everything" ], "env": {} } } }
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.