registry/tools/publisher

MCP Registry Publisher Tool

The MCP Registry Publisher Tool is designed to publish Model Context Protocol (MCP) server details to an MCP registry. This tool currently only handles GitHub authentication via device flow and manages the publishing process.

Building the Tool

You can build the publisher tool using the provided build script:

# Build for current platform
./build.sh

# Build for all supported platforms (optional)
./build.sh --all

The compiled binary will be placed in the bin directory.

Usage

# Basic usage
./bin/mcp-publisher --registry-url <REGISTRY_URL> --mcp-file <PATH_TO_MCP_FILE>

# Force a new login even if a token exists
./bin/mcp-publisher --registry-url <REGISTRY_URL> --mcp-file <PATH_TO_MCP_FILE> --login

Command-line Arguments

• --registry-url: URL of the MCP registry (required)
• --mcp-file: Path to the MCP configuration file (required)
• --login: Force a new GitHub authentication even if a token already exists (overwrites existing token file)
• --token: Use the provided token instead of GitHub authentication (bypasses the device flow)

Authentication

The tool uses GitHub device flow authentication:

1. The tool automatically retrieves the GitHub Client ID from the registry's health endpoint
2. When first run (or with --login flag), the tool will initiate the GitHub device flow
3. You'll be provided with a URL and a code to enter
4. After successful authentication, the tool saves the token locally for future use
5. The token is sent in the HTTP Authorization header with the Bearer scheme

NOTE : Authentication is made on behalf of a OAuth App which you must authorize for respective resources (e.g org)

Example

1. Prepare your mcp.json file with your server details:

{
  "name": "io.github.yourusername/your-repository",
  "description": "Your MCP server description",
  "version_detail": {
    "version": "1.0.0"
  },
  "packages": [
    {
      "registry_name": "npm",
      "name": "your-npm-package",
      "version": "1.0.0",
      "package_arguments": [
        {
          "description": "Specify services and permissions",
          "is_required": true,
          "format": "string",
          "value": "-s",
          "default": "-s",
          "type": "positional",
          "value_hint": "-s"
        }
      ],
      "environment_variables": [
        {
          "name": "API_KEY",
          "description": "API Key to access the server"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/yourusername/your-repository",
    "source": "github"
  }
}

2. Run the publisher tool:

./bin/mcp-publisher --registry-url "https://mcp-registry.example.com" --mcp-file "./mcp.json"

3. Follow the authentication instructions in the terminal if prompted.

4. Upon successful publication, you'll see a confirmation message.

Important Notes

• The GitHub Client ID is automatically retrieved from the registry's health endpoint
• The authentication token is saved in a file named .mcpregistry_token in the current directory
• The tool requires an active internet connection to authenticate with GitHub and communicate with the registry
• Make sure the repository and package mentioned in your mcp.json file exist and are accessible