MCP Discovery

MCP Discovery

A lightweight CLI tool built in Rust for discovering MCP server capabilities.

64
Stars
8
Forks
16
Releases

Overview

MCP Discovery is a command-line tool written in Rust for discovering and documenting MCP Server capabilities. It can display MCP details, including tools, resources, and capabilities, directly in the terminal or save them to files in Markdown, HTML, plain text, JSON, or via a custom Handlebars template. The tool can generate new documentation files, or update existing ones by inserting MCP server capabilities between designated render markers. Built-in templates (md, md-plain, html, txt) provide ready-to-use formats, while custom templates allow advanced customization. It is designed to be used in automation as a GitHub Action to keep server documentation up to date. The project leverages the rust-mcp-sdk for interacting with MCP Servers. Subcommands include print (display in terminal), create (generate a new file), and update (refresh an existing file). Update regions are defined by markers such as mcp-discovery-render and mcp-discovery-render-end, with optional template blocks to render inline templates. Inline templates are supported for update operations. See the project documentation for usage examples.

Details

Owner
rust-mcp-stack
Language
Rust
License
MIT License
Updated
2025-12-07

Features

Display MCP Details

Output MCP Server information, including tools, resources, and capabilities, directly to the terminal.

Generate Files

Create files in Markdown (.md), HTML (.html), or plain text (.txt) formats with MCP Server details and capabilities.

Update Files

Modify existing Markdown, HTML, or text files by adding MCP Server capabilities within specified markers, enabling automatic documentation maintenance.

Flexible Output Customization

Choose built-in templates (md, md-plain, html, txt) or supply custom Handlebars templates for personalized output.

MCP Discovery GitHub Action

Integrate the CLI as a GitHub Action to automate and maintain up-to-date MCP Server documentation in your workflow.

Audience

MCP Server DevelopersDiscover MCP server capabilities and automatically generate or update documentation files.

Tags

MCPMCP DiscoveryCLIRustHandlebarsTemplatesMarkdownHTMLPlain TextJSONDocumentationGitHub ActionServer capabilitiesToolsResources