complete-example.json

{
  "$schema": "../schemas/server-definition.schema.json",
  "id": "com.github-mcp",
  "name": "GitHub",
  "alias": "gh",
  "description": "Interact with GitHub repositories, issues, pull requests, and more through the GitHub API.",
  "icon": "🐙",
  "schema_version": "2.1",
  "categories": ["developer-tools", "version-control"],
  "tags": ["git", "code", "issues", "pr", "repos"],

  "transport": {
    "type": "stdio",
    "command": "docker",
    "args": [
      "run", "-i", "--rm", "-e",
      "GITHUB_PERSONAL_ACCESS_TOKEN",
      "ghcr.io/github/github-mcp-server"
    ],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:GITHUB_TOKEN}"
    },
    "metadata": {
      "inputs": [
        {
          "id": "GITHUB_TOKEN",
          "label": "GitHub Personal Access Token",
          "description": "Token used to authenticate with GitHub API",
          "type": "password",
          "required": true,
          "secret": true,
          "placeholder": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "obtain": {
            "url": "https://github.com/settings/tokens/new",
            "instructions": "1. Click 'Generate new token (classic)'\n2. Give it a name like 'McpMux'\n3. Select scopes: repo, read:org\n4. Click 'Generate token'\n5. Copy the token (starts with ghp_)",
            "button_label": "Create Token"
          }
        }
      ]
    }
  },

  "auth": {
    "type": "api_key",
    "instructions": "Create a token at https://github.com/settings/tokens with repo scope"
  },

  "contributor": {
    "name": "Model Context Protocol",
    "github": "modelcontextprotocol",
    "url": "https://modelcontextprotocol.io"
  },

  "links": {
    "repository": "https://github.com/modelcontextprotocol/servers",
    "documentation": "https://modelcontextprotocol.io/docs"
  },

  "platforms": ["all"],

  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false,
    "read_only_mode": false
  }
}