Mcp Discovery Action

MCP Discovery Action

A GitHub Action to run the MCP Discovery CLI for creating, updating or printing MCP server capability details in a Markdown or other formatted file.

💡 Check out the rust-mcp-filesystem capabilities page for sample output and an example workflow: mcp-discovery.yml.

Overview

This action runs the MCP Discovery CLI to discover MCP server capabilities and create/update a file with MCP server details (create or update commands). It supports all CLI options, including built-in templates (md, md-plain, html, txt), custom Handlebars template files, or template strings.

The action downloads the latest version of the CLI binary by default, but you can specify a specific version using the action's version input.

Inputs

| Input | Description | Required | Default | | --- | --- | --- | --- | | command | CLI command to run (create, update or print). | Yes | - | | mcp-launch-command | Command and arguments to launch the MCP server (e.g., java -jar mcp.jar). | Yes | - | | filename | Output file path for create/update commands (e.g., docs/mcp-details.md). | No | mcp-discovery.md | | template | Built-in template for output (md, md-plain, html, txt). | No | - | | template-file | Path to a custom Handlebars template file in the repository. | No | - | | template-string | Custom Handlebars template content as a string. | No | - | | log-level | Specifies the logging level for the CLI | No | info | | token | Optional GitHub token with content write permission. | No | ${{ github.token }} | | version | Version of the mcp-discovery CLI to use (e.g., v0.1.2). Use latest for the latest release. | No | latest |

💡 For more information and command examples, refer to the MCP Discovery documentation.

Usage

Example 1: Create a Markdown File

Create mcp-discovery.md with MCP server capabilities and commit it if changed.

name: MCP Discovery (create)
on:
  push:
    branches:
      - main
permissions:
  contents: write
jobs:
  generate-md:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'create'
          mcp-launch-command: '[THE COMMAND YOU USE TO START YOUR MCP SERVER]'
          filename: 'mcp-discovery.md'

Example 2: Update a designated section of the README.md file

💡 For more information about update command and template markers, visit MCP Discovery documentation.

name: MCP Discovery (update)
on:
  push:
    branches:
      - main
permissions:
  contents: write
jobs:
  generate-md:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'update'
          mcp-launch-command: '[THE COMMAND YOU USE TO START YOUR MCP SERVER]'
          filename: 'README.md'

Contributing

Contributions are welcome! Please open an issue or pull request in the mcp-discovery-action repository.

License

MIT License. See [LICENSE](LICENSE) for details.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rust-mcp-stack
• Source: rust-mcp-stack/mcp-discovery-action
• License: MIT
• Homepage: https://rust-mcp-stack.github.io/mcp-discovery/

Install and usage instructions live in the source repository linked above.