Docs

Author: masegraye

docs/generator/reference/docker_mcp.yaml

@@ -12,6 +12,7 @@ cname:
     - docker mcp catalog
     - docker mcp client
     - docker mcp config
+    - docker mcp feature
     - docker mcp gateway
     - docker mcp policy
     - docker mcp secret
@@ -22,6 +23,7 @@ clink:
     - docker_mcp_catalog.yaml
     - docker_mcp_client.yaml
     - docker_mcp_config.yaml
+    - docker_mcp_feature.yaml
     - docker_mcp_gateway.yaml
     - docker_mcp_policy.yaml
     - docker_mcp_secret.yaml

docs/generator/reference/docker_mcp_catalog.yaml

@@ -1,19 +1,34 @@
 command: docker mcp catalog
 aliases: docker mcp catalog, docker mcp catalogs
-short: Manage the catalog
-long: Manage the catalog
+short: Manage MCP server catalogs
+long: |
+    Manage MCP server catalogs for organizing and configuring custom MCP servers alongside Docker's official catalog.
 pname: docker mcp
 plink: docker_mcp.yaml
 cname:
+    - docker mcp catalog add
+    - docker mcp catalog bootstrap
+    - docker mcp catalog create
+    - docker mcp catalog export
+    - docker mcp catalog fork
+    - docker mcp catalog import
     - docker mcp catalog init
     - docker mcp catalog ls
     - docker mcp catalog reset
+    - docker mcp catalog rm
     - docker mcp catalog show
     - docker mcp catalog update
 clink:
+    - docker_mcp_catalog_add.yaml
+    - docker_mcp_catalog_bootstrap.yaml
+    - docker_mcp_catalog_create.yaml
+    - docker_mcp_catalog_export.yaml
+    - docker_mcp_catalog_fork.yaml
+    - docker_mcp_catalog_import.yaml
     - docker_mcp_catalog_init.yaml
     - docker_mcp_catalog_ls.yaml
     - docker_mcp_catalog_reset.yaml
+    - docker_mcp_catalog_rm.yaml
     - docker_mcp_catalog_show.yaml
     - docker_mcp_catalog_update.yaml
 deprecated: false

docs/generator/reference/docker_mcp_catalog_add.yaml

@@ -1,6 +1,8 @@
 command: docker mcp catalog add
-short: Add a server to your catalog
-long: Add a server to your catalog
+short: Add a server to a catalog
+long: |-
+    Add an MCP server definition to an existing catalog by copying it from another catalog file.
+    The server definition includes all configuration, tools, and metadata.
 usage: docker mcp catalog add <catalog> <server-name> <catalog-file>
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
@@ -15,8 +17,9 @@ options:
       experimentalcli: false
       kubernetes: false
       swarm: false
+examples: "  # Add a server from another catalog file\n  docker mcp catalog add my-catalog github-server ./github-catalog.yaml\n  \n  # Add with force to overwrite existing server\n  docker mcp catalog add my-catalog slack-bot ./team-catalog.yaml --force"
 deprecated: false
-hidden: true
+hidden: false
 experimental: false
 experimentalcli: false
 kubernetes: false

docs/generator/reference/docker_mcp_catalog_bootstrap.yaml

@@ -0,0 +1,20 @@
+command: docker mcp catalog bootstrap
+short: |
+    Create a starter catalog file with Docker and Docker Hub server entries as examples
+long: |-
+    Create a starter catalog file with Docker Hub and Docker CLI server entries as examples.
+    This command extracts the official Docker server definitions and creates a properly formatted
+    catalog file that users can modify and use as a foundation for their custom catalogs.
+
+    The output file is standalone and not automatically imported - users can modify it and then
+    import it or use it as a source for the 'catalog add' command.
+usage: docker mcp catalog bootstrap <output-file-path>
+pname: docker mcp catalog
+plink: docker_mcp_catalog.yaml
+deprecated: false
+hidden: false
+experimental: false
+experimentalcli: false
+kubernetes: false
+swarm: false
+

docs/generator/reference/docker_mcp_catalog_create.yaml

@@ -1,11 +1,13 @@
 command: docker mcp catalog create
-short: Create a new catalog
-long: Create a new catalog
+short: Create a new empty catalog
+long: |
+    Create a new empty catalog for organizing custom MCP servers. The catalog will be stored locally and can be populated using 'docker mcp catalog add'.
 usage: docker mcp catalog create <name>
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
+examples: "  # Create a new catalog for development servers\n  docker mcp catalog create dev-servers\n  \n  # Create a catalog for production monitoring tools  \n  docker mcp catalog create prod-monitoring"
 deprecated: false
-hidden: true
+hidden: false
 experimental: false
 experimentalcli: false
 kubernetes: false

docs/generator/reference/docker_mcp_catalog_export.yaml

@@ -0,0 +1,16 @@
+command: docker mcp catalog export
+short: Export a configured catalog to a file
+long: |-
+    Export a user-managed catalog to a file. This command only works with catalogs
+    that have been imported or configured manually. The canonical Docker MCP catalog
+    cannot be exported as it is managed by Docker.
+usage: docker mcp catalog export <catalog-name> <file-path>
+pname: docker mcp catalog
+plink: docker_mcp_catalog.yaml
+deprecated: false
+hidden: false
+experimental: false
+experimentalcli: false
+kubernetes: false
+swarm: false
+

docs/generator/reference/docker_mcp_catalog_fork.yaml

@@ -1,11 +1,13 @@
 command: docker mcp catalog fork
-short: Fork a catalog
-long: Fork a catalog
+short: Create a copy of an existing catalog
+long: |
+    Create a new catalog by copying all servers from an existing catalog. Useful for creating variations of existing catalogs.
 usage: docker mcp catalog fork <src-catalog> <new-name>
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
+examples: "  # Fork the Docker catalog to customize it\n  docker mcp catalog fork docker-mcp my-custom-docker\n  \n  # Fork a team catalog for personal use\n  docker mcp catalog fork team-servers my-servers"
 deprecated: false
-hidden: true
+hidden: false
 experimental: false
 experimentalcli: false
 kubernetes: false

docs/generator/reference/docker_mcp_catalog_import.yaml

@@ -1,11 +1,12 @@
 command: docker mcp catalog import
-short: Import a catalog
-long: Import a catalog
+short: Import a catalog from URL or file
+long: "Import an MCP server catalog from a URL or local file. The catalog will be downloaded \nand stored locally for use with the MCP gateway."
 usage: docker mcp catalog import <alias|url|file>
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
+examples: "  # Import from URL\n  docker mcp catalog import https://example.com/my-catalog.yaml\n  \n  # Import from local file\n  docker mcp catalog import ./shared-catalog.yaml"
 deprecated: false
-hidden: true
+hidden: false
 experimental: false
 experimentalcli: false
 kubernetes: false

docs/generator/reference/docker_mcp_catalog_init.yaml

@@ -1,9 +1,13 @@
 command: docker mcp catalog init
-short: Initialize the catalog
-long: Initialize the catalog
+short: Initialize the catalog system
+long: |
+    Initialize the local catalog management system by creating the necessary configuration files and directories.
 usage: docker mcp catalog init
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
+examples: |4-
+      # Initialize catalog system
+      docker mcp catalog init
 deprecated: false
 hidden: false
 experimental: false

docs/generator/reference/docker_mcp_catalog_ls.yaml

@@ -1,6 +1,7 @@
 command: docker mcp catalog ls
-short: List configured catalogs
-long: List configured catalogs
+short: List all configured catalogs
+long: |
+    List all configured catalogs including Docker's official catalog and any locally managed catalogs.
 usage: docker mcp catalog ls
 pname: docker mcp catalog
 plink: docker_mcp_catalog.yaml
@@ -15,6 +16,7 @@ options:
       experimentalcli: false
       kubernetes: false
       swarm: false
+examples: "  # List all catalogs\n  docker mcp catalog ls\n  \n  # List catalogs in JSON format\n  docker mcp catalog ls --json"
 deprecated: false
 hidden: false
 experimental: false