From f4addc2d36d7eb0366534d0f127a73c0610fed29 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Wed, 8 Oct 2025 11:36:05 +0200 Subject: [PATCH 1/2] update mcp reference to v0.22.0 Signed-off-by: Sebastiaan van Stijn --- .../docs/generator/reference/docker_mcp.yaml | 2 + .../reference/docker_mcp_catalog.yaml | 19 +++++- .../reference/docker_mcp_catalog_add.yaml | 9 ++- .../docker_mcp_catalog_bootstrap.yaml | 20 ++++++ .../reference/docker_mcp_catalog_create.yaml | 8 ++- .../reference/docker_mcp_catalog_export.yaml | 16 +++++ .../reference/docker_mcp_catalog_fork.yaml | 8 ++- .../reference/docker_mcp_catalog_import.yaml | 27 +++++++- .../reference/docker_mcp_catalog_init.yaml | 8 ++- .../reference/docker_mcp_catalog_ls.yaml | 18 +++-- .../reference/docker_mcp_catalog_reset.yaml | 8 ++- .../reference/docker_mcp_catalog_rm.yaml | 9 ++- .../reference/docker_mcp_catalog_show.yaml | 14 +++- .../reference/docker_mcp_catalog_update.yaml | 12 +++- .../reference/docker_mcp_client_connect.yaml | 6 +- .../docker_mcp_client_disconnect.yaml | 6 +- .../reference/docker_mcp_feature.yaml | 24 +++++++ .../reference/docker_mcp_feature_disable.yaml | 13 ++++ .../reference/docker_mcp_feature_enable.yaml | 19 ++++++ .../reference/docker_mcp_feature_list.yaml | 14 ++++ .../reference/docker_mcp_feature_ls.yaml | 15 +++++ .../reference/docker_mcp_gateway_run.yaml | 51 +++++++++++++++ .../reference/docker_mcp_import.yaml | 49 ++++++++++++++ .../reference/docker_mcp_oauth_authorize.yaml | 10 +++ .../reference/docker_mcp_registry.yaml | 16 +++++ .../docker_mcp_registry_convert.yaml | 23 +++++++ .../reference/docker_mcp_server.yaml | 2 + .../reference/docker_mcp_server_import.yaml | 24 +++++++ .../reference/docker_mcp_server_inspect.yaml | 4 +- .../reference/docker_mcp_server_list.yaml | 2 +- .../reference/docker_mcp_server_ls.yaml | 25 +++++++ .../generator/reference/docker_mcp_tools.yaml | 12 ++-- .../reference/docker_mcp_tools_disable.yaml | 65 +++++++++++++++++++ .../reference/docker_mcp_tools_enable.yaml | 65 +++++++++++++++++++ .../reference/docker_mcp_tools_ls.yaml | 55 ++++++++++++++++ .../docs/generator/reference/mcp.md | 5 +- .../docs/generator/reference/mcp_catalog.md | 23 ++++--- .../generator/reference/mcp_catalog_add.md | 15 +++++ .../reference/mcp_catalog_bootstrap.md | 13 ++++ .../generator/reference/mcp_catalog_create.md | 8 +++ .../generator/reference/mcp_catalog_export.md | 10 +++ .../generator/reference/mcp_catalog_fork.md | 8 +++ .../generator/reference/mcp_catalog_import.md | 19 ++++++ .../generator/reference/mcp_catalog_init.md | 2 +- .../generator/reference/mcp_catalog_ls.md | 8 +-- .../generator/reference/mcp_catalog_reset.md | 2 +- .../generator/reference/mcp_catalog_rm.md | 9 +++ .../generator/reference/mcp_catalog_show.md | 3 +- .../generator/reference/mcp_catalog_update.md | 3 +- .../docs/generator/reference/mcp_client.md | 10 +-- .../generator/reference/mcp_client_connect.md | 2 +- .../reference/mcp_client_disconnect.md | 2 +- .../docs/generator/reference/mcp_feature.md | 20 ++++++ .../reference/mcp_feature_disable.md | 8 +++ .../generator/reference/mcp_feature_enable.md | 13 ++++ .../generator/reference/mcp_feature_list.md | 8 +++ .../generator/reference/mcp_feature_ls.md | 12 ++++ .../generator/reference/mcp_gateway_run.md | 57 ++++++++-------- .../docs/generator/reference/mcp_import.md | 22 +++++++ .../docs/generator/reference/mcp_server.md | 13 ++-- .../generator/reference/mcp_server_import.md | 14 ++++ .../generator/reference/mcp_server_inspect.md | 2 +- .../generator/reference/mcp_server_list.md | 18 +++++ .../docs/generator/reference/mcp_server_ls.md | 18 +++++ .../docs/generator/reference/mcp_tools.md | 16 +++-- .../generator/reference/mcp_tools_disable.md | 18 +++++ .../generator/reference/mcp_tools_enable.md | 18 +++++ .../docs/generator/reference/mcp_tools_ls.md | 21 ++++++ _vendor/modules.txt | 2 +- go.mod | 5 +- go.sum | 2 + 71 files changed, 994 insertions(+), 113 deletions(-) create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_bootstrap.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_export.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_disable.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_enable.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_list.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_ls.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_import.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry_convert.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_import.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_ls.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_disable.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_enable.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_ls.yaml create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_add.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_bootstrap.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_create.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_export.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_fork.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_import.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_rm.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_disable.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_enable.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_list.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_ls.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_import.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_import.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_list.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_ls.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_disable.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_enable.md create mode 100644 _vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_ls.md diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp.yaml index 2abcf6299355..83b5306c8602 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog.yaml index b893dc7b01c5..b4e06d5e5c7f 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_add.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_add.yaml index a78c133cc6d4..9821a62b104d 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_add.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_bootstrap.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_bootstrap.yaml new file mode 100644 index 000000000000..9a896ea8a118 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/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 +pname: docker mcp catalog +plink: docker_mcp_catalog.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_create.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_create.yaml index 6e6de0abe154..fc21ddf06bb3 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_create.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_export.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_export.yaml new file mode 100644 index 000000000000..fbee66f0c77c --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/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 +pname: docker mcp catalog +plink: docker_mcp_catalog.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_fork.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_fork.yaml index aa291c588030..d8c1e7e6ba85 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_fork.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_import.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_import.yaml index 3bd7714ab480..1ad165c3a7eb 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_import.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_import.yaml @@ -1,11 +1,32 @@ 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.\n\nWhen --mcp-registry flag is used, the argument must be an existing catalog name, and the\ncommand will import servers from the MCP registry URL into that catalog." usage: docker mcp catalog import pname: docker mcp catalog plink: docker_mcp_catalog.yaml +options: + - option: dry-run + value_type: bool + default_value: "false" + description: Show Imported Data but do not update the Catalog + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: mcp-registry + value_type: string + description: Import server from MCP registry URL into existing catalog + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +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\n \n # Import from MCP registry URL into existing catalog\n docker mcp catalog import my-catalog --mcp-registry https://registry.example.com/server" deprecated: false -hidden: true +hidden: false experimental: false experimentalcli: false kubernetes: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_init.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_init.yaml index 0d1722edf977..685e63105b96 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_init.yaml +++ b/_vendor/github.com/docker/mcp-gateway/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 diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_ls.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_ls.yaml index 716837f653ac..19d88c99c862 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_ls.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_ls.yaml @@ -1,20 +1,26 @@ 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 options: - - option: json - value_type: bool - default_value: "false" - description: Print as JSON. + - option: format + value_type: format + description: 'Output format. Supported: "json", "yaml".' deprecated: false hidden: false experimental: false experimentalcli: false kubernetes: false swarm: false +examples: |4- + # List all catalogs + docker mcp catalog ls + + # List catalogs in JSON format + docker mcp catalog ls --format=json deprecated: false hidden: false experimental: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_reset.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_reset.yaml index af65e75c9dbf..39dd38b7036b 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_reset.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_reset.yaml @@ -1,10 +1,14 @@ command: docker mcp catalog reset aliases: docker mcp catalog reset, docker mcp catalog empty -short: Empty the catalog -long: Empty the catalog +short: Reset the catalog system +long: | + Reset the local catalog management system by removing all user-managed catalogs and configuration. This does not affect Docker's official catalog. usage: docker mcp catalog reset pname: docker mcp catalog plink: docker_mcp_catalog.yaml +examples: |4- + # Reset all user catalogs + docker mcp catalog reset deprecated: false hidden: false experimental: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_rm.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_rm.yaml index 69e3aa46fa36..4e2e9dacc79f 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_rm.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_rm.yaml @@ -1,11 +1,16 @@ command: docker mcp catalog rm short: Remove a catalog -long: Remove a catalog +long: |- + Remove a locally configured catalog. This will delete the catalog and all its server definitions. + The Docker official catalog cannot be removed. usage: docker mcp catalog rm pname: docker mcp catalog plink: docker_mcp_catalog.yaml +examples: |4- + # Remove a catalog + docker mcp catalog rm old-servers deprecated: false -hidden: true +hidden: false experimental: false experimentalcli: false kubernetes: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_show.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_show.yaml index b9a0c61eb82a..23a98c289f44 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_show.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_show.yaml @@ -1,7 +1,9 @@ command: docker mcp catalog show -short: Show a catalog -long: Show a catalog -usage: docker mcp catalog show +short: Display catalog contents +long: |- + Display the contents of a catalog including all server definitions and metadata. + If no name is provided, shows the Docker official catalog. +usage: docker mcp catalog show [name] pname: docker mcp catalog plink: docker_mcp_catalog.yaml options: @@ -14,6 +16,12 @@ options: experimentalcli: false kubernetes: false swarm: false +examples: |4- + # Show Docker's official catalog + docker mcp catalog show + + # Show a specific catalog in JSON format + docker mcp catalog show my-catalog --format=json deprecated: false hidden: false experimental: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_update.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_update.yaml index 95f8af2cf781..08c5f99de9b7 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_update.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_catalog_update.yaml @@ -1,9 +1,17 @@ command: docker mcp catalog update -short: Update a specific catalog or all catalogs if no name is provided -long: Update a specific catalog or all catalogs if no name is provided +short: Update catalog(s) from remote sources +long: |- + Update one or more catalogs by re-downloading from their original sources. + If no name is provided, updates all catalogs that have remote sources. usage: docker mcp catalog update [name] pname: docker mcp catalog plink: docker_mcp_catalog.yaml +examples: |4- + # Update all catalogs + docker mcp catalog update + + # Update specific catalog + docker mcp catalog update team-servers deprecated: false hidden: false experimental: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_connect.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_connect.yaml index 002f928c3644..273747d81bd1 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_connect.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_connect.yaml @@ -1,12 +1,12 @@ command: docker mcp client connect short: | - Connect the Docker MCP Toolkit to a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Connect the Docker MCP Toolkit to a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed long: | - Connect the Docker MCP Toolkit to a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Connect the Docker MCP Toolkit to a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed usage: |- docker mcp client connect [OPTIONS] - Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed pname: docker mcp client plink: docker_mcp_client.yaml options: diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_disconnect.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_disconnect.yaml index 3b8058f07182..41f8394403dc 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_disconnect.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_client_disconnect.yaml @@ -1,12 +1,12 @@ command: docker mcp client disconnect short: | - Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed long: | - Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed usage: |- docker mcp client disconnect [OPTIONS] - Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode + Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed pname: docker mcp client plink: docker_mcp_client.yaml options: diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature.yaml new file mode 100644 index 000000000000..5c554f2873aa --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature.yaml @@ -0,0 +1,24 @@ +command: docker mcp feature +short: Manage experimental features +long: |- + Manage experimental features for Docker MCP Gateway. + + Features are stored in your Docker configuration file (~/.docker/config.json) + and control optional functionality that may change in future versions. +pname: docker mcp +plink: docker_mcp.yaml +cname: + - docker mcp feature disable + - docker mcp feature enable + - docker mcp feature ls +clink: + - docker_mcp_feature_disable.yaml + - docker_mcp_feature_enable.yaml + - docker_mcp_feature_ls.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_disable.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_disable.yaml new file mode 100644 index 000000000000..4304c4e8efde --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_disable.yaml @@ -0,0 +1,13 @@ +command: docker mcp feature disable +short: Disable an experimental feature +long: Disable an experimental feature that was previously enabled. +usage: docker mcp feature disable +pname: docker mcp feature +plink: docker_mcp_feature.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_enable.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_enable.yaml new file mode 100644 index 000000000000..b2af805bbe72 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_enable.yaml @@ -0,0 +1,19 @@ +command: docker mcp feature enable +short: Enable an experimental feature +long: |- + Enable an experimental feature. + + Available features: + oauth-interceptor Enable GitHub OAuth flow interception for automatic authentication + mcp-oauth-dcr Enable Dynamic Client Registration (DCR) for automatic OAuth client setup + dynamic-tools Enable internal MCP management tools (mcp-find, mcp-add, mcp-remove) +usage: docker mcp feature enable +pname: docker mcp feature +plink: docker_mcp_feature.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_list.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_list.yaml new file mode 100644 index 000000000000..19f779f5a5b5 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_list.yaml @@ -0,0 +1,14 @@ +command: docker mcp feature list +short: List all available features and their status +long: | + List all available experimental features and show whether they are enabled or disabled. +usage: docker mcp feature list +pname: docker mcp feature +plink: docker_mcp_feature.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_ls.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_ls.yaml new file mode 100644 index 000000000000..6901df268a32 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_feature_ls.yaml @@ -0,0 +1,15 @@ +command: docker mcp feature ls +aliases: docker mcp feature ls, docker mcp feature list +short: List all available features and their status +long: | + List all available experimental features and show whether they are enabled or disabled. +usage: docker mcp feature ls +pname: docker mcp feature +plink: docker_mcp_feature.yaml +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_gateway_run.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_gateway_run.yaml index b7ae5685e51b..534f66d9cf97 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_gateway_run.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_gateway_run.yaml @@ -35,6 +35,16 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: additional-tools-config + value_type: stringSlice + default_value: '[]' + description: Additional tools paths to merge with the default tools.yaml + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: block-network value_type: bool default_value: "false" @@ -117,6 +127,17 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: enable-all-servers + value_type: bool + default_value: "false" + description: | + Enable all servers in the catalog (instead of using individual --servers options) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: interceptor value_type: stringArray default_value: '[]' @@ -149,6 +170,16 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: mcp-registry + value_type: stringSlice + default_value: '[]' + description: MCP registry URLs to fetch servers from (can be repeated) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: memory value_type: string default_value: 2Gb @@ -159,6 +190,16 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: oci-ref + value_type: stringArray + default_value: '[]' + description: OCI image references to use + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: port value_type: int default_value: "0" @@ -222,6 +263,16 @@ options: experimentalcli: false kubernetes: false swarm: false + - option: tools-config + value_type: stringSlice + default_value: '[tools.yaml]' + description: Paths to the tools files (absolute or relative to ~/.docker/mcp/) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false - option: transport value_type: string default_value: stdio diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_import.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_import.yaml new file mode 100644 index 000000000000..6bff46f46fa3 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_import.yaml @@ -0,0 +1,49 @@ +command: docker mcp import +short: Import a server +long: |- + Import and parse a server definition from an official MCP registry URL. + + This command fetches the server definition from the provided URL, parses it as a ServerDetail, + converts it to the internal Server format, and displays the results. + + Example: + docker mcp officialregistry import https://registry.example.com/servers/my-server +usage: docker mcp import +pname: docker mcp +plink: docker_mcp.yaml +options: + - option: catalog + value_type: string + description: import to local catalog + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: mcp-registry + value_type: string + description: import from MCP registry format + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: push + value_type: bool + default_value: "false" + description: push the new server artifact + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_oauth_authorize.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_oauth_authorize.yaml index a597c2660ded..18feb00aed65 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_oauth_authorize.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_oauth_authorize.yaml @@ -4,6 +4,16 @@ long: Authorize the specified OAuth app. usage: docker mcp oauth authorize pname: docker mcp oauth plink: docker_mcp_oauth.yaml +options: + - option: scopes + value_type: string + description: OAuth scopes to request (space-separated) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false deprecated: false hidden: true experimental: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry.yaml new file mode 100644 index 000000000000..285def738d90 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry.yaml @@ -0,0 +1,16 @@ +command: docker mcp registry +short: Registry operations +long: Registry operations +pname: docker mcp +plink: docker_mcp.yaml +cname: + - docker mcp registry convert +clink: + - docker_mcp_registry_convert.yaml +deprecated: false +hidden: true +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry_convert.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry_convert.yaml new file mode 100644 index 000000000000..5affc6bcd9a1 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_registry_convert.yaml @@ -0,0 +1,23 @@ +command: docker mcp registry convert +short: Convert OCI registry server definition to catalog server format +long: Convert OCI registry server definition to catalog server format +usage: docker mcp registry convert +pname: docker mcp registry +plink: docker_mcp_registry.yaml +options: + - option: file + value_type: string + description: Path to the OCI registry server definition JSON file + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: true +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server.yaml index 4356a0a7522f..aa0911ebf19e 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server.yaml @@ -7,11 +7,13 @@ cname: - docker mcp server disable - docker mcp server enable - docker mcp server inspect + - docker mcp server ls - docker mcp server reset clink: - docker_mcp_server_disable.yaml - docker_mcp_server_enable.yaml - docker_mcp_server_inspect.yaml + - docker_mcp_server_ls.yaml - docker_mcp_server_reset.yaml deprecated: false hidden: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_import.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_import.yaml new file mode 100644 index 000000000000..f2ab943fd63c --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_import.yaml @@ -0,0 +1,24 @@ +command: docker mcp server import +short: Import a server +long: Import a server +usage: docker mcp server import +pname: docker mcp server +plink: docker_mcp_server.yaml +options: + - option: push + value_type: bool + default_value: "false" + description: push the new server artifact + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_inspect.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_inspect.yaml index b00348be91a1..058bf11d157a 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_inspect.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_inspect.yaml @@ -1,6 +1,6 @@ command: docker mcp server inspect -short: Get information about a server -long: Get information about a server +short: Get information about a server or inspect an OCI artifact +long: Get information about a server or inspect an OCI artifact usage: docker mcp server inspect pname: docker mcp server plink: docker_mcp_server.yaml diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_list.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_list.yaml index f7d567ebb41c..ccaa2eaa49ce 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_list.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_list.yaml @@ -17,7 +17,7 @@ options: kubernetes: false swarm: false deprecated: false -hidden: true +hidden: false experimental: false experimentalcli: false kubernetes: false diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_ls.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_ls.yaml new file mode 100644 index 000000000000..52e6c85c2e1e --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_server_ls.yaml @@ -0,0 +1,25 @@ +command: docker mcp server ls +aliases: docker mcp server ls, docker mcp server list +short: List enabled servers +long: List enabled servers +usage: docker mcp server ls +pname: docker mcp server +plink: docker_mcp_server.yaml +options: + - option: json + value_type: bool + default_value: "false" + description: Output in JSON format + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools.yaml index a26852534e8e..6696a010cdc9 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools.yaml +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools.yaml @@ -1,18 +1,22 @@ command: docker mcp tools -short: List/count/call MCP tools -long: List/count/call MCP tools +short: Manage tools +long: Manage tools pname: docker mcp plink: docker_mcp.yaml cname: - docker mcp tools call - docker mcp tools count + - docker mcp tools disable + - docker mcp tools enable - docker mcp tools inspect - - docker mcp tools list + - docker mcp tools ls clink: - docker_mcp_tools_call.yaml - docker_mcp_tools_count.yaml + - docker_mcp_tools_disable.yaml + - docker_mcp_tools_enable.yaml - docker_mcp_tools_inspect.yaml - - docker_mcp_tools_list.yaml + - docker_mcp_tools_ls.yaml options: - option: format value_type: string diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_disable.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_disable.yaml new file mode 100644 index 000000000000..378c0089c5d1 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_disable.yaml @@ -0,0 +1,65 @@ +command: docker mcp tools disable +short: disable one or more tools +long: disable one or more tools +usage: docker mcp tools disable [tool1] [tool2] ... +pname: docker mcp tools +plink: docker_mcp_tools.yaml +options: + - option: server + value_type: string + description: | + Specify which server provides the tools (optional, will auto-discover if not provided) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: format + value_type: string + default_value: list + description: Output format (json|list) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: gateway-arg + value_type: stringSlice + default_value: '[]' + description: Additional arguments passed to the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: verbose + value_type: bool + default_value: "false" + description: Verbose output + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: version + value_type: string + default_value: "2" + description: Version of the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_enable.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_enable.yaml new file mode 100644 index 000000000000..7392e63bcb5d --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_enable.yaml @@ -0,0 +1,65 @@ +command: docker mcp tools enable +short: enable one or more tools +long: enable one or more tools +usage: docker mcp tools enable [tool1] [tool2] ... +pname: docker mcp tools +plink: docker_mcp_tools.yaml +options: + - option: server + value_type: string + description: | + Specify which server provides the tools (optional, will auto-discover if not provided) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +inherited_options: + - option: format + value_type: string + default_value: list + description: Output format (json|list) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: gateway-arg + value_type: stringSlice + default_value: '[]' + description: Additional arguments passed to the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: verbose + value_type: bool + default_value: "false" + description: Verbose output + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: version + value_type: string + default_value: "2" + description: Version of the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_ls.yaml b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_ls.yaml new file mode 100644 index 000000000000..b349ae2b4e05 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/docker_mcp_tools_ls.yaml @@ -0,0 +1,55 @@ +command: docker mcp tools ls +aliases: docker mcp tools ls, docker mcp tools list +short: List tools +long: List tools +usage: docker mcp tools ls +pname: docker mcp tools +plink: docker_mcp_tools.yaml +inherited_options: + - option: format + value_type: string + default_value: list + description: Output format (json|list) + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: gateway-arg + value_type: stringSlice + default_value: '[]' + description: Additional arguments passed to the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: verbose + value_type: bool + default_value: "false" + description: Verbose output + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false + - option: version + value_type: string + default_value: "2" + description: Version of the gateway + deprecated: false + hidden: false + experimental: false + experimentalcli: false + kubernetes: false + swarm: false +deprecated: false +hidden: false +experimental: false +experimentalcli: false +kubernetes: false +swarm: false + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp.md index 1aab77347b33..4cdac747df02 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp.md @@ -7,14 +7,15 @@ Manage MCP servers and clients | Name | Description | |:----------------------------|:------------------------------| -| [`catalog`](mcp_catalog.md) | Manage the catalog | +| [`catalog`](mcp_catalog.md) | Manage MCP server catalogs | | [`client`](mcp_client.md) | Manage MCP clients | | [`config`](mcp_config.md) | Manage the configuration | +| [`feature`](mcp_feature.md) | Manage experimental features | | [`gateway`](mcp_gateway.md) | Manage the MCP Server gateway | | [`policy`](mcp_policy.md) | Manage secret policies | | [`secret`](mcp_secret.md) | Manage secrets | | [`server`](mcp_server.md) | Manage servers | -| [`tools`](mcp_tools.md) | List/count/call MCP tools | +| [`tools`](mcp_tools.md) | Manage tools | | [`version`](mcp_version.md) | Show the version information | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog.md index 46cc1f7e6479..e32d1cd8c95a 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog.md @@ -1,7 +1,7 @@ # docker mcp catalog -Manage the catalog +Manage MCP server catalogs for organizing and configuring custom MCP servers alongside Docker's official catalog. ### Aliases @@ -9,13 +9,20 @@ Manage the catalog ### Subcommands -| Name | Description | -|:----------------------------------|:-----------------------------------------------------------------| -| [`init`](mcp_catalog_init.md) | Initialize the catalog | -| [`ls`](mcp_catalog_ls.md) | List configured catalogs | -| [`reset`](mcp_catalog_reset.md) | Empty the catalog | -| [`show`](mcp_catalog_show.md) | Show a catalog | -| [`update`](mcp_catalog_update.md) | Update a specific catalog or all catalogs if no name is provided | +| Name | Description | +|:----------------------------------------|:------------------------------------------------------------------------------------| +| [`add`](mcp_catalog_add.md) | Add a server to a catalog | +| [`bootstrap`](mcp_catalog_bootstrap.md) | Create a starter catalog file with Docker and Docker Hub server entries as examples | +| [`create`](mcp_catalog_create.md) | Create a new empty catalog | +| [`export`](mcp_catalog_export.md) | Export a configured catalog to a file | +| [`fork`](mcp_catalog_fork.md) | Create a copy of an existing catalog | +| [`import`](mcp_catalog_import.md) | Import a catalog from URL or file | +| [`init`](mcp_catalog_init.md) | Initialize the catalog system | +| [`ls`](mcp_catalog_ls.md) | List all configured catalogs | +| [`reset`](mcp_catalog_reset.md) | Reset the catalog system | +| [`rm`](mcp_catalog_rm.md) | Remove a catalog | +| [`show`](mcp_catalog_show.md) | Display catalog contents | +| [`update`](mcp_catalog_update.md) | Update catalog(s) from remote sources | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_add.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_add.md new file mode 100644 index 000000000000..6a44a93de48d --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_add.md @@ -0,0 +1,15 @@ +# docker mcp catalog add + + +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. + +### Options + +| Name | Type | Default | Description | +|:----------|:-------|:--------|:-----------------------------------------| +| `--force` | `bool` | | Overwrite existing server in the catalog | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_bootstrap.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_bootstrap.md new file mode 100644 index 000000000000..72db3ccc4c66 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_bootstrap.md @@ -0,0 +1,13 @@ +# docker mcp catalog bootstrap + + +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. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_create.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_create.md new file mode 100644 index 000000000000..5cba22d1b09c --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_create.md @@ -0,0 +1,8 @@ +# docker mcp catalog create + + +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'. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_export.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_export.md new file mode 100644 index 000000000000..dd6ba629890e --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_export.md @@ -0,0 +1,10 @@ +# docker mcp catalog export + + +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. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_fork.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_fork.md new file mode 100644 index 000000000000..9a96a2383f2a --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_fork.md @@ -0,0 +1,8 @@ +# docker mcp catalog fork + + +Create a new catalog by copying all servers from an existing catalog. Useful for creating variations of existing catalogs. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_import.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_import.md new file mode 100644 index 000000000000..8de3382884b4 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_import.md @@ -0,0 +1,19 @@ +# docker mcp catalog import + + +Import an MCP server catalog from a URL or local file. The catalog will be downloaded +and stored locally for use with the MCP gateway. + +When --mcp-registry flag is used, the argument must be an existing catalog name, and the +command will import servers from the MCP registry URL into that catalog. + +### Options + +| Name | Type | Default | Description | +|:-----------------|:---------|:--------|:----------------------------------------------------------| +| `--dry-run` | `bool` | | Show Imported Data but do not update the Catalog | +| `--mcp-registry` | `string` | | Import server from MCP registry URL into existing catalog | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_init.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_init.md index 918a0f927fd8..9e798f920830 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_init.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_init.md @@ -1,7 +1,7 @@ # docker mcp catalog init -Initialize the catalog +Initialize the local catalog management system by creating the necessary configuration files and directories. diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_ls.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_ls.md index c9f90778ec58..bfaa5e2a022d 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_ls.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_ls.md @@ -1,13 +1,13 @@ # docker mcp catalog ls -List configured catalogs +List all configured catalogs including Docker's official catalog and any locally managed catalogs. ### Options -| Name | Type | Default | Description | -|:---------|:-------|:--------|:---------------| -| `--json` | `bool` | | Print as JSON. | +| Name | Type | Default | Description | +|:-----------|:---------|:--------|:------------------------------------------| +| `--format` | `format` | | Output format. Supported: "json", "yaml". | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_reset.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_reset.md index e9cae110f4c8..bb248a25b5dc 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_reset.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_reset.md @@ -1,7 +1,7 @@ # docker mcp catalog reset -Empty the catalog +Reset the local catalog management system by removing all user-managed catalogs and configuration. This does not affect Docker's official catalog. ### Aliases diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_rm.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_rm.md new file mode 100644 index 000000000000..71d4bdca4219 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_rm.md @@ -0,0 +1,9 @@ +# docker mcp catalog rm + + +Remove a locally configured catalog. This will delete the catalog and all its server definitions. +The Docker official catalog cannot be removed. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_show.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_show.md index e0162bb24438..3fef55156676 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_show.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_show.md @@ -1,7 +1,8 @@ # docker mcp catalog show -Show a catalog +Display the contents of a catalog including all server definitions and metadata. +If no name is provided, shows the Docker official catalog. ### Options diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_update.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_update.md index 01bc750490a8..e323b0c72296 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_update.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_catalog_update.md @@ -1,7 +1,8 @@ # docker mcp catalog update -Update a specific catalog or all catalogs if no name is provided +Update one or more catalogs by re-downloading from their original sources. +If no name is provided, updates all catalogs that have remote sources. diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client.md index dc5f40508eb7..d33f95587f30 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client.md @@ -5,11 +5,11 @@ Manage MCP clients ### Subcommands -| Name | Description | -|:-----------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------| -| [`connect`](mcp_client_connect.md) | Connect the Docker MCP Toolkit to a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode | -| [`disconnect`](mcp_client_disconnect.md) | Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode | -| [`ls`](mcp_client_ls.md) | List client configurations | +| Name | Description | +|:-----------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| [`connect`](mcp_client_connect.md) | Connect the Docker MCP Toolkit to a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed | +| [`disconnect`](mcp_client_disconnect.md) | Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed | +| [`ls`](mcp_client_ls.md) | List client configurations | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_connect.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_connect.md index 140dce781161..70ee4105b56c 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_connect.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_connect.md @@ -1,7 +1,7 @@ # docker mcp client connect -Connect the Docker MCP Toolkit to a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode +Connect the Docker MCP Toolkit to a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed ### Options diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_disconnect.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_disconnect.md index a4f86d9a6a4d..5999cf9cb7a7 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_disconnect.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_client_disconnect.md @@ -1,7 +1,7 @@ # docker mcp client disconnect -Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-desktop continue cursor gemini goose gordon lmstudio sema4 vscode +Disconnect the Docker MCP Toolkit from a client. Supported clients: claude-code claude-desktop codex continue cursor gemini goose gordon lmstudio opencode sema4 vscode zed ### Options diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature.md new file mode 100644 index 000000000000..47ed39e085d4 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature.md @@ -0,0 +1,20 @@ +# docker mcp feature + + +Manage experimental features for Docker MCP Gateway. + +Features are stored in your Docker configuration file (~/.docker/config.json) +and control optional functionality that may change in future versions. + +### Subcommands + +| Name | Description | +|:------------------------------------|:---------------------------------------------| +| [`disable`](mcp_feature_disable.md) | Disable an experimental feature | +| [`enable`](mcp_feature_enable.md) | Enable an experimental feature | +| [`ls`](mcp_feature_ls.md) | List all available features and their status | + + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_disable.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_disable.md new file mode 100644 index 000000000000..24dec78e2021 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_disable.md @@ -0,0 +1,8 @@ +# docker mcp feature disable + + +Disable an experimental feature that was previously enabled. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_enable.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_enable.md new file mode 100644 index 000000000000..58468fc7dda9 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_enable.md @@ -0,0 +1,13 @@ +# docker mcp feature enable + + +Enable an experimental feature. + +Available features: + oauth-interceptor Enable GitHub OAuth flow interception for automatic authentication + mcp-oauth-dcr Enable Dynamic Client Registration (DCR) for automatic OAuth client setup + dynamic-tools Enable internal MCP management tools (mcp-find, mcp-add, mcp-remove) + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_list.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_list.md new file mode 100644 index 000000000000..15b57a71d5b8 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_list.md @@ -0,0 +1,8 @@ +# docker mcp feature list + + +List all available experimental features and show whether they are enabled or disabled. + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_ls.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_ls.md new file mode 100644 index 000000000000..ca26f8d3fdec --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_feature_ls.md @@ -0,0 +1,12 @@ +# docker mcp feature ls + + +List all available experimental features and show whether they are enabled or disabled. + +### Aliases + +`docker mcp feature ls`, `docker mcp feature list` + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_gateway_run.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_gateway_run.md index 5b366582f378..218b2ef54e9c 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_gateway_run.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_gateway_run.md @@ -5,32 +5,37 @@ Run the gateway ### Options -| Name | Type | Default | Description | -|:------------------------|:--------------|:--------------------|:----------------------------------------------------------------------------------------------------------------------------------------------| -| `--additional-catalog` | `stringSlice` | | Additional catalog paths to append to the default catalogs | -| `--additional-config` | `stringSlice` | | Additional config paths to merge with the default config.yaml | -| `--additional-registry` | `stringSlice` | | Additional registry paths to merge with the default registry.yaml | -| `--block-network` | `bool` | | Block tools from accessing forbidden network resources | -| `--block-secrets` | `bool` | `true` | Block secrets from being/received sent to/from tools | -| `--catalog` | `stringSlice` | `[docker-mcp.yaml]` | Paths to docker catalogs (absolute or relative to ~/.docker/mcp/catalogs/) | -| `--config` | `stringSlice` | `[config.yaml]` | Paths to the config files (absolute or relative to ~/.docker/mcp/) | -| `--cpus` | `int` | `1` | CPUs allocated to each MCP Server (default is 1) | -| `--debug-dns` | `bool` | | Debug DNS resolution | -| `--dry-run` | `bool` | | Start the gateway but do not listen for connections (useful for testing the configuration) | -| `--interceptor` | `stringArray` | | List of interceptors to use (format: when:type:path, e.g. 'before:exec:/bin/path') | -| `--log-calls` | `bool` | `true` | Log calls to the tools | -| `--long-lived` | `bool` | | Containers are long-lived and will not be removed until the gateway is stopped, useful for stateful servers | -| `--memory` | `string` | `2Gb` | Memory allocated to each MCP Server (default is 2Gb) | -| `--port` | `int` | `0` | TCP port to listen on (default is to listen on stdio) | -| `--registry` | `stringSlice` | `[registry.yaml]` | Paths to the registry files (absolute or relative to ~/.docker/mcp/) | -| `--secrets` | `string` | `docker-desktop` | Colon separated paths to search for secrets. Can be `docker-desktop` or a path to a .env file (default to using Docker Desktop's secrets API) | -| `--servers` | `stringSlice` | | Names of the servers to enable (if non empty, ignore --registry flag) | -| `--static` | `bool` | | Enable static mode (aka pre-started servers) | -| `--tools` | `stringSlice` | | List of tools to enable | -| `--transport` | `string` | `stdio` | stdio, sse or streaming (default is stdio) | -| `--verbose` | `bool` | | Verbose output | -| `--verify-signatures` | `bool` | | Verify signatures of the server images | -| `--watch` | `bool` | `true` | Watch for changes and reconfigure the gateway | +| Name | Type | Default | Description | +|:----------------------------|:--------------|:--------------------|:----------------------------------------------------------------------------------------------------------------------------------------------| +| `--additional-catalog` | `stringSlice` | | Additional catalog paths to append to the default catalogs | +| `--additional-config` | `stringSlice` | | Additional config paths to merge with the default config.yaml | +| `--additional-registry` | `stringSlice` | | Additional registry paths to merge with the default registry.yaml | +| `--additional-tools-config` | `stringSlice` | | Additional tools paths to merge with the default tools.yaml | +| `--block-network` | `bool` | | Block tools from accessing forbidden network resources | +| `--block-secrets` | `bool` | `true` | Block secrets from being/received sent to/from tools | +| `--catalog` | `stringSlice` | `[docker-mcp.yaml]` | Paths to docker catalogs (absolute or relative to ~/.docker/mcp/catalogs/) | +| `--config` | `stringSlice` | `[config.yaml]` | Paths to the config files (absolute or relative to ~/.docker/mcp/) | +| `--cpus` | `int` | `1` | CPUs allocated to each MCP Server (default is 1) | +| `--debug-dns` | `bool` | | Debug DNS resolution | +| `--dry-run` | `bool` | | Start the gateway but do not listen for connections (useful for testing the configuration) | +| `--enable-all-servers` | `bool` | | Enable all servers in the catalog (instead of using individual --servers options) | +| `--interceptor` | `stringArray` | | List of interceptors to use (format: when:type:path, e.g. 'before:exec:/bin/path') | +| `--log-calls` | `bool` | `true` | Log calls to the tools | +| `--long-lived` | `bool` | | Containers are long-lived and will not be removed until the gateway is stopped, useful for stateful servers | +| `--mcp-registry` | `stringSlice` | | MCP registry URLs to fetch servers from (can be repeated) | +| `--memory` | `string` | `2Gb` | Memory allocated to each MCP Server (default is 2Gb) | +| `--oci-ref` | `stringArray` | | OCI image references to use | +| `--port` | `int` | `0` | TCP port to listen on (default is to listen on stdio) | +| `--registry` | `stringSlice` | `[registry.yaml]` | Paths to the registry files (absolute or relative to ~/.docker/mcp/) | +| `--secrets` | `string` | `docker-desktop` | Colon separated paths to search for secrets. Can be `docker-desktop` or a path to a .env file (default to using Docker Desktop's secrets API) | +| `--servers` | `stringSlice` | | Names of the servers to enable (if non empty, ignore --registry flag) | +| `--static` | `bool` | | Enable static mode (aka pre-started servers) | +| `--tools` | `stringSlice` | | List of tools to enable | +| `--tools-config` | `stringSlice` | `[tools.yaml]` | Paths to the tools files (absolute or relative to ~/.docker/mcp/) | +| `--transport` | `string` | `stdio` | stdio, sse or streaming (default is stdio) | +| `--verbose` | `bool` | | Verbose output | +| `--verify-signatures` | `bool` | | Verify signatures of the server images | +| `--watch` | `bool` | `true` | Watch for changes and reconfigure the gateway | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_import.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_import.md new file mode 100644 index 000000000000..2c763bdcbe25 --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_import.md @@ -0,0 +1,22 @@ +# docker mcp import + + +Import and parse a server definition from an official MCP registry URL. + +This command fetches the server definition from the provided URL, parses it as a ServerDetail, +converts it to the internal Server format, and displays the results. + +Example: + docker mcp officialregistry import https://registry.example.com/servers/my-server + +### Options + +| Name | Type | Default | Description | +|:-----------------|:---------|:--------|:--------------------------------| +| `--catalog` | `string` | | import to local catalog | +| `--mcp-registry` | `string` | | import from MCP registry format | +| `--push` | `bool` | | push the new server artifact | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server.md index 75ae21c56498..e06050dc7495 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server.md @@ -5,12 +5,13 @@ Manage servers ### Subcommands -| Name | Description | -|:-----------------------------------|:-------------------------------------| -| [`disable`](mcp_server_disable.md) | Disable a server or multiple servers | -| [`enable`](mcp_server_enable.md) | Enable a server or multiple servers | -| [`inspect`](mcp_server_inspect.md) | Get information about a server | -| [`reset`](mcp_server_reset.md) | Disable all the servers | +| Name | Description | +|:-----------------------------------|:----------------------------------------------------------| +| [`disable`](mcp_server_disable.md) | Disable a server or multiple servers | +| [`enable`](mcp_server_enable.md) | Enable a server or multiple servers | +| [`inspect`](mcp_server_inspect.md) | Get information about a server or inspect an OCI artifact | +| [`ls`](mcp_server_ls.md) | List enabled servers | +| [`reset`](mcp_server_reset.md) | Disable all the servers | diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_import.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_import.md new file mode 100644 index 000000000000..df38bbe4e9be --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_import.md @@ -0,0 +1,14 @@ +# docker mcp server import + + +Import a server + +### Options + +| Name | Type | Default | Description | +|:---------|:-------|:--------|:-----------------------------| +| `--push` | `bool` | | push the new server artifact | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_inspect.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_inspect.md index df6a7574868d..c691beb1ab97 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_inspect.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_inspect.md @@ -1,7 +1,7 @@ # docker mcp server inspect -Get information about a server +Get information about a server or inspect an OCI artifact diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_list.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_list.md new file mode 100644 index 000000000000..66d50cceda5d --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_list.md @@ -0,0 +1,18 @@ +# docker mcp server list + + +List enabled servers + +### Aliases + +`docker mcp server list`, `docker mcp server ls` + +### Options + +| Name | Type | Default | Description | +|:---------|:-------|:--------|:----------------------| +| `--json` | `bool` | | Output in JSON format | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_ls.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_ls.md new file mode 100644 index 000000000000..56a0d121076b --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_server_ls.md @@ -0,0 +1,18 @@ +# docker mcp server ls + + +List enabled servers + +### Aliases + +`docker mcp server ls`, `docker mcp server list` + +### Options + +| Name | Type | Default | Description | +|:---------|:-------|:--------|:----------------------| +| `--json` | `bool` | | Output in JSON format | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools.md index 11f293348797..8f1afd8a0d62 100644 --- a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools.md +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools.md @@ -1,16 +1,18 @@ # docker mcp tools -List/count/call MCP tools +Manage tools ### Subcommands -| Name | Description | -|:----------------------------------|:---------------| -| [`call`](mcp_tools_call.md) | Call a tool | -| [`count`](mcp_tools_count.md) | Count tools | -| [`inspect`](mcp_tools_inspect.md) | Inspect a tool | -| [`list`](mcp_tools_list.md) | List tools | +| Name | Description | +|:----------------------------------|:--------------------------| +| [`call`](mcp_tools_call.md) | Call a tool | +| [`count`](mcp_tools_count.md) | Count tools | +| [`disable`](mcp_tools_disable.md) | disable one or more tools | +| [`enable`](mcp_tools_enable.md) | enable one or more tools | +| [`inspect`](mcp_tools_inspect.md) | Inspect a tool | +| [`ls`](mcp_tools_ls.md) | List tools | ### Options diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_disable.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_disable.md new file mode 100644 index 000000000000..4afd266e39ea --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_disable.md @@ -0,0 +1,18 @@ +# docker mcp tools disable + + +disable one or more tools + +### Options + +| Name | Type | Default | Description | +|:----------------|:--------------|:--------|:---------------------------------------------------------------------------------------| +| `--format` | `string` | `list` | Output format (json\|list) | +| `--gateway-arg` | `stringSlice` | | Additional arguments passed to the gateway | +| `--server` | `string` | | Specify which server provides the tools (optional, will auto-discover if not provided) | +| `--verbose` | `bool` | | Verbose output | +| `--version` | `string` | `2` | Version of the gateway | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_enable.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_enable.md new file mode 100644 index 000000000000..7498953401ef --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_enable.md @@ -0,0 +1,18 @@ +# docker mcp tools enable + + +enable one or more tools + +### Options + +| Name | Type | Default | Description | +|:----------------|:--------------|:--------|:---------------------------------------------------------------------------------------| +| `--format` | `string` | `list` | Output format (json\|list) | +| `--gateway-arg` | `stringSlice` | | Additional arguments passed to the gateway | +| `--server` | `string` | | Specify which server provides the tools (optional, will auto-discover if not provided) | +| `--verbose` | `bool` | | Verbose output | +| `--version` | `string` | `2` | Version of the gateway | + + + + diff --git a/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_ls.md b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_ls.md new file mode 100644 index 000000000000..358b1151270a --- /dev/null +++ b/_vendor/github.com/docker/mcp-gateway/docs/generator/reference/mcp_tools_ls.md @@ -0,0 +1,21 @@ +# docker mcp tools ls + + +List tools + +### Aliases + +`docker mcp tools ls`, `docker mcp tools list` + +### Options + +| Name | Type | Default | Description | +|:----------------|:--------------|:--------|:-------------------------------------------| +| `--format` | `string` | `list` | Output format (json\|list) | +| `--gateway-arg` | `stringSlice` | | Additional arguments passed to the gateway | +| `--verbose` | `bool` | | Verbose output | +| `--version` | `string` | `2` | Version of the gateway | + + + + diff --git a/_vendor/modules.txt b/_vendor/modules.txt index ce110a822cae..fe1c8f0190fe 100644 --- a/_vendor/modules.txt +++ b/_vendor/modules.txt @@ -4,5 +4,5 @@ # github.com/docker/cli v28.5.1+incompatible # github.com/docker/compose/v2 v2.40.0 # github.com/docker/model-runner/cmd/cli v0.1.44 -# github.com/docker/mcp-gateway v0.13.1-0.20250730013131-e08a3be84765 +# github.com/docker/mcp-gateway v0.22.0 # github.com/docker/scout-cli v1.18.4 diff --git a/go.mod b/go.mod index f983cfc9382f..ab6a35c4b6f1 100644 --- a/go.mod +++ b/go.mod @@ -34,7 +34,7 @@ require ( github.com/docker/docker-credential-helpers v0.9.3 // indirect github.com/docker/go-connections v0.6.0 // indirect github.com/docker/go-units v0.5.0 // indirect - github.com/docker/mcp-gateway v0.13.1-0.20250730013131-e08a3be84765 // indirect + github.com/docker/mcp-gateway v0.22.0 // indirect github.com/docker/model-distribution v0.0.0-20250918153037-7d9fc7b72b57 // indirect github.com/docker/model-runner v0.0.0-20250911130340-38bb0171c947 // indirect github.com/docker/model-runner/cmd/cli v0.1.44 // indirect @@ -138,6 +138,5 @@ replace ( github.com/docker/scout-cli => github.com/docker/scout-cli v1.18.4 github.com/moby/buildkit => github.com/moby/buildkit v0.25.0 github.com/moby/moby => github.com/moby/moby v28.5.1+incompatible + github.com/docker/mcp-gateway => github.com/docker/mcp-gateway v0.22.0 ) - -replace github.com/docker/mcp-gateway => github.com/docker/mcp-gateway v0.13.1-0.20250730013131-e08a3be84765 diff --git a/go.sum b/go.sum index 41d628aa4549..2b55622f7532 100644 --- a/go.sum +++ b/go.sum @@ -128,6 +128,8 @@ github.com/docker/mcp-gateway v0.13.1-0.20250725123702-8e89765b8e23 h1:K6eT3ES75 github.com/docker/mcp-gateway v0.13.1-0.20250725123702-8e89765b8e23/go.mod h1:UQ2De7vreEHLHCGtpn/yentfqR49W5Br9rr9N7R8GKU= github.com/docker/mcp-gateway v0.13.1-0.20250730013131-e08a3be84765 h1:mySoEboZo2nHFeeZt5bHNt1DBNfzyTDvhZlOx2BS5JQ= github.com/docker/mcp-gateway v0.13.1-0.20250730013131-e08a3be84765/go.mod h1:fgjFpcHItWEFKbClB4hINY4W15g+tCtC5T0j1PwCYzk= +github.com/docker/mcp-gateway v0.22.0 h1:l4t+HRNHxR7Jn545KDeXaeiEEhkCDBeWMTyuCaXVH7A= +github.com/docker/mcp-gateway v0.22.0/go.mod h1:4sGoRoMeu8lj4a/HbAd/jdxXjMNVMegNnjCqmhsED+I= github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01 h1:UL/07fs6IEdRWWkK+GRvmSTZM+9fugWzEeo2vdGIPoE= github.com/docker/model-cli v0.1.26-0.20250527144806-15d0078a3c01/go.mod h1:1YlKTiA19vEhbmM8EiJVPUFvRifBBI1S3sBpOt6Gbl4= github.com/docker/model-cli v0.1.26-0.20250529165100-f4b458125149 h1:uOLJ8d/isN/mqvr5rEFHVL3pBAWvnjfEEcvPLHJ2JSI= From bb847bd16e322e9741b92a03e0b383829e5b80aa Mon Sep 17 00:00:00 2001 From: Sebastiaan van Stijn Date: Wed, 8 Oct 2025 12:18:46 +0200 Subject: [PATCH 2/2] reference: mcp: add markdown stubs for new subcommands Signed-off-by: Sebastiaan van Stijn --- .../cli/docker/mcp/catalog/catalog_bootstrap.md | 15 +++++++++++++++ .../cli/docker/mcp/catalog/catalog_export.md | 15 +++++++++++++++ .../{tools/tools_list.md => feature/_index.md} | 4 ++-- .../cli/docker/mcp/feature/feature_disable.md | 15 +++++++++++++++ .../cli/docker/mcp/feature/feature_enable.md | 15 +++++++++++++++ .../cli/docker/mcp/feature/feature_ls.md | 17 +++++++++++++++++ .../mcp/server/{server_list.md => server_ls.md} | 2 ++ .../cli/docker/mcp/tools/tools_disable.md | 15 +++++++++++++++ .../cli/docker/mcp/tools/tools_enable.md | 15 +++++++++++++++ .../reference/cli/docker/mcp/tools/tools_ls.md | 17 +++++++++++++++++ 10 files changed, 128 insertions(+), 2 deletions(-) create mode 100644 content/reference/cli/docker/mcp/catalog/catalog_bootstrap.md create mode 100644 content/reference/cli/docker/mcp/catalog/catalog_export.md rename content/reference/cli/docker/mcp/{tools/tools_list.md => feature/_index.md} (82%) create mode 100644 content/reference/cli/docker/mcp/feature/feature_disable.md create mode 100644 content/reference/cli/docker/mcp/feature/feature_enable.md create mode 100644 content/reference/cli/docker/mcp/feature/feature_ls.md rename content/reference/cli/docker/mcp/server/{server_list.md => server_ls.md} (86%) create mode 100644 content/reference/cli/docker/mcp/tools/tools_disable.md create mode 100644 content/reference/cli/docker/mcp/tools/tools_enable.md create mode 100644 content/reference/cli/docker/mcp/tools/tools_ls.md diff --git a/content/reference/cli/docker/mcp/catalog/catalog_bootstrap.md b/content/reference/cli/docker/mcp/catalog/catalog_bootstrap.md new file mode 100644 index 000000000000..067b4c719a95 --- /dev/null +++ b/content/reference/cli/docker/mcp/catalog/catalog_bootstrap.md @@ -0,0 +1,15 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_catalog_bootstrap +title: docker mcp catalog bootstrap +layout: cli +--- + + + diff --git a/content/reference/cli/docker/mcp/catalog/catalog_export.md b/content/reference/cli/docker/mcp/catalog/catalog_export.md new file mode 100644 index 000000000000..3ae8ae6b53cf --- /dev/null +++ b/content/reference/cli/docker/mcp/catalog/catalog_export.md @@ -0,0 +1,15 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_catalog_export +title: docker mcp catalog export +layout: cli +--- + + + diff --git a/content/reference/cli/docker/mcp/tools/tools_list.md b/content/reference/cli/docker/mcp/feature/_index.md similarity index 82% rename from content/reference/cli/docker/mcp/tools/tools_list.md rename to content/reference/cli/docker/mcp/feature/_index.md index c24bb41c28a4..3675666e3691 100644 --- a/content/reference/cli/docker/mcp/tools/tools_list.md +++ b/content/reference/cli/docker/mcp/feature/_index.md @@ -1,7 +1,7 @@ --- datafolder: mcp-cli -datafile: docker_mcp_tools_list -title: docker mcp tools list +datafile: docker_mcp_feature +title: docker mcp feature layout: cli --- diff --git a/content/reference/cli/docker/mcp/feature/feature_disable.md b/content/reference/cli/docker/mcp/feature/feature_disable.md new file mode 100644 index 000000000000..c8f7e49b61b1 --- /dev/null +++ b/content/reference/cli/docker/mcp/feature/feature_disable.md @@ -0,0 +1,15 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_feature_disable +title: docker mcp feature disable +layout: cli +--- + + + diff --git a/content/reference/cli/docker/mcp/feature/feature_enable.md b/content/reference/cli/docker/mcp/feature/feature_enable.md new file mode 100644 index 000000000000..bfc6df0be834 --- /dev/null +++ b/content/reference/cli/docker/mcp/feature/feature_enable.md @@ -0,0 +1,15 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_feature_enable +title: docker mcp feature enable +layout: cli +--- + + + diff --git a/content/reference/cli/docker/mcp/feature/feature_ls.md b/content/reference/cli/docker/mcp/feature/feature_ls.md new file mode 100644 index 000000000000..a550fadeb4b2 --- /dev/null +++ b/content/reference/cli/docker/mcp/feature/feature_ls.md @@ -0,0 +1,17 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_feature_ls +title: docker mcp feature ls +layout: cli +aliases: + - /reference/cli/docker/mcp/feature/list/ +--- + + + diff --git a/content/reference/cli/docker/mcp/server/server_list.md b/content/reference/cli/docker/mcp/server/server_ls.md similarity index 86% rename from content/reference/cli/docker/mcp/server/server_list.md rename to content/reference/cli/docker/mcp/server/server_ls.md index fe164b3b61c2..ec5da9013ab0 100644 --- a/content/reference/cli/docker/mcp/server/server_list.md +++ b/content/reference/cli/docker/mcp/server/server_ls.md @@ -3,6 +3,8 @@ datafolder: mcp-cli datafile: docker_mcp_server_list title: docker mcp server list layout: cli +aliases: + - /reference/cli/docker/mcp/server/list/ --- + diff --git a/content/reference/cli/docker/mcp/tools/tools_enable.md b/content/reference/cli/docker/mcp/tools/tools_enable.md new file mode 100644 index 000000000000..5ff223c32dd4 --- /dev/null +++ b/content/reference/cli/docker/mcp/tools/tools_enable.md @@ -0,0 +1,15 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_tools_enable +title: docker mcp tools enable +layout: cli +--- + + + diff --git a/content/reference/cli/docker/mcp/tools/tools_ls.md b/content/reference/cli/docker/mcp/tools/tools_ls.md new file mode 100644 index 000000000000..c82898a8187f --- /dev/null +++ b/content/reference/cli/docker/mcp/tools/tools_ls.md @@ -0,0 +1,17 @@ +--- +datafolder: mcp-cli +datafile: docker_mcp_tools_ls +title: docker mcp tools ls +layout: cli +aliases: + - /reference/cli/docker/mcp/tools/list/ +--- + + +