MCP Discovery Action

Created By

rust-mcp-stack8 months ago

GitHub Action for the mcp-discovery CLI

Content

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'