MCP Discovery
Created 5 months ago
A command-line tool written in Rust for discovering and documenting MCP Server capabilities.
What is MCP Discovery?
A lightweight CLI tool built in Rust for discovering MCP server capabilities.
Documentation
Installation# Running as CLI
Check the project documentation for instructions on installing the tool on different platforms.
GitHub Action
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.
Subcommands
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.
Options
-f, --filename: Used withcreateandupdatecommands to specify the output file to generate or modify.-t, --template: Choose a built-in output template. Options:md,md-plain,html,txt.-p, --template-file: Path to a custom Handlebars template file.-s, --template-string: Inline Handlebars template provided as a string.-h, --help: Display help information.-V, --version: Display the version ofmcp-discovery.
Built-in Templates
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.
Custom Templates
You can provide custom Handlebars templates in different ways:
- Use the
--template-fileflag to provide a custom template file. - Use the
--template-stringflag to provide a raw Handlebars template directly as a string. - To use an inline template, define it in a file for the
updatecommand only — this will not function with print or create.
Defining Update Regions with Markers
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.
Contributing
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.
Server Config
{
"mcpServers": {
"mcp-discovery-server": {
"command": "npx",
"args": [
"mcp-discovery"
]
}
}
}