From 9e33ba708e78e163ef6672ee40b4a7401279e20b Mon Sep 17 00:00:00 2001 From: ArthurFlag Date: Fri, 27 Jun 2025 11:25:55 +0200 Subject: [PATCH 1/4] add MCP Gateway --- assets/css/components.css | 2 +- content/manuals/_index.md | 5 ++ .../ai/mcp-catalog-and-toolkit/toolkit.md | 6 +- content/manuals/ai/mcp-gateway/_index.md | 82 +++++++++++++++++++ 4 files changed, 93 insertions(+), 2 deletions(-) create mode 100644 content/manuals/ai/mcp-gateway/_index.md diff --git a/assets/css/components.css b/assets/css/components.css index 4e7a2234d3a..cf34ab86c0c 100644 --- a/assets/css/components.css +++ b/assets/css/components.css @@ -95,7 +95,7 @@ } } .button { - @apply mt-1 inline-block rounded-sm bg-blue-500 p-1 px-3 text-blue-50 text-white hover:bg-blue-600 dark:bg-blue-500 hover:dark:bg-blue-400; + @apply my-2 mr-2 inline-block rounded-sm bg-blue-500 p-1 px-3 text-blue-50 text-white hover:bg-blue-600 dark:bg-blue-500 hover:dark:bg-blue-400; } .summary-bar { diff --git a/content/manuals/_index.md b/content/manuals/_index.md index 726d25917c0..ec01e323ee0 100644 --- a/content/manuals/_index.md +++ b/content/manuals/_index.md @@ -31,6 +31,11 @@ params: description: Run containers programmatically in your preferred programming language. icon: /icons/Testcontainers.svg link: /testcontainers/ + - title: MCP Gateway + description: Manage and secure your AI tools with a single gateway. + icon: /icons/toolkit.svg + link: /ai/mcp-gateway/ + ai: - title: Ask Gordon description: Streamline your workflow and get the most out of the Docker ecosystem with your personal AI assistant. diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md index 729d4347952..d9c2af7c340 100644 --- a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md +++ b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md @@ -7,7 +7,7 @@ aliases: - /ai/gordon/mcp/gordon-mcp-server/ --- -The Docker MCP Toolkit enables seamless setup, management, and execution of containerized MCP servers and their connections to AI agents. It removes the friction from tool usage by offering secure defaults, one-click setup, and support for a growing ecosystem of LLM-based clients. It is the fastest path from MCP tool discovery to local execution. +The Docker MCP Toolkit is a gateway that enables seamless setup, management, and execution of containerized MCP servers and their connections to AI agents. It removes the friction from tool usage by offering secure defaults, one-click setup, and support for a growing ecosystem of LLM-based clients. It is the fastest path from MCP tool discovery to local execution. ## Key features @@ -160,3 +160,7 @@ and add Claude Desktop as a client: ```text Take a screenshot of docs.docker.com and then invert the colors ``` + +## Related pages + +- [Open-source MCP Gateway](/manuals/ai/mcp-gateway/_index.md) diff --git a/content/manuals/ai/mcp-gateway/_index.md b/content/manuals/ai/mcp-gateway/_index.md new file mode 100644 index 00000000000..5c0f7663b89 --- /dev/null +++ b/content/manuals/ai/mcp-gateway/_index.md @@ -0,0 +1,82 @@ +--- +title: MCP Gateway +description: "Docker's MCP Gateway provides secure, centralized, and scalable orchestration of AI tools through containerized MCP servers—empowering developers, operators, and security teams." +keywords: MCP Gateway +params: + sidebar: + group: Open source +--- + +The MCP Gateway is Docker's open-source enterprise-ready solution for orchestrating and +managing [Model Context Protocol (MCP)](https://spec.modelcontextprotocol.io/) servers +securely across development and production environments. +It is designed to help organizations connect AI +agents from the [Docker MCP Catalog](https://hub.docker.com/mcp) to internal infrastructure +without compromising security, visibility, or control. + +By unifying multiple MCP servers into a single, secure endpoint, the MCP Gateway offers +the following benefits: + +- Secure by Default: MCP servers run in isolated Docker containers with restricted + privileges, network access, and resource usage. +- Unified Management: One gateway endpoint centralizes configuration, credentials, + and access control for all MCP servers. +- Enterprise Observability: Built-in monitoring, logging, and filtering tools ensure + full visibility and governance of AI tool activity. + +## Who is the MCP Gateway designed for? + +The MCP Gateway solves problems encountered by various groups: + +- Developers: Deploy MCP servers locally and in production using Docker Compose, + with built-in support for protocol handling, credential management, and security policies. +- Security Teams: Achieve enterprise-grade isolation and visibility into AI tool + behavior and access patterns. +- Operators: Scale effortlessly from local development environments to production + infrastructure with consistent, low-touch operations. + +## Key features + +- Server Management: List, inspect, and call MCP tools, resoures and prompts from multiple servers +- Container-based Servers: Run MCP servers as Docker containers with proper isolation +- Secrets Management: Secure handling of API keys and credentials via Docker Desktop +- OAuth Integration: Built-in OAuth flows for service authentication +- Server Catalog: Manage and configure multiple MCP catalogs +- Dynamic Discovery: Automatic tool, prompt, and resource discovery from running servers +- Monitoring: Built-in logging and call tracing capabilities + +## Install the MCP Gateway + +### Prerequisites + +- Docker Desktop is installed. +- The MCP Toolkit feature is [enabled](/manuals/ai/mcp-catalog-and-toolkit/toolkit.md#enable-docker-mcp-toolkit). +- Go 1.24+ (for development) + +### Install as Docker CLI Plugin + +The MCP CLI is already installed on recent versions of Docker Desktop. +To update to the latest version: + +```bash +# Clone the repository +git clone https://github.com/docker/docker-mcp.git +cd docker-mcp + +# Build and install the plugin +make docker-mcp +``` + +You can now use the `mcp` command: + +```bash +docker mcp --help +``` + +## Use the MCP Gateway + +To view all the commands and configuration options, go to the [docker-mcp repository](https://github.com/docker/docker-mcp). + +## Related pages + +- [Docker MCP toolkit and catalog](/manuals/ai/mcp-catalog-and-toolkit/_index.md) From 83e4cb1c38423dd65fe30f165df0fbf5cccf6fcc Mon Sep 17 00:00:00 2001 From: ArthurFlag Date: Fri, 27 Jun 2025 16:30:08 +0200 Subject: [PATCH 2/4] feedback --- content/manuals/ai/mcp-gateway/_index.md | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/content/manuals/ai/mcp-gateway/_index.md b/content/manuals/ai/mcp-gateway/_index.md index 5c0f7663b89..80fe2e3bd26 100644 --- a/content/manuals/ai/mcp-gateway/_index.md +++ b/content/manuals/ai/mcp-gateway/_index.md @@ -10,9 +10,7 @@ params: The MCP Gateway is Docker's open-source enterprise-ready solution for orchestrating and managing [Model Context Protocol (MCP)](https://spec.modelcontextprotocol.io/) servers securely across development and production environments. -It is designed to help organizations connect AI -agents from the [Docker MCP Catalog](https://hub.docker.com/mcp) to internal infrastructure -without compromising security, visibility, or control. +It is designed to help organizations connect MCP servers from the [Docker MCP Catalog](https://hub.docker.com/mcp) to MCP Clients without compromising security, visibility, or control. By unifying multiple MCP servers into a single, secure endpoint, the MCP Gateway offers the following benefits: @@ -40,19 +38,17 @@ The MCP Gateway solves problems encountered by various groups: - Server Management: List, inspect, and call MCP tools, resoures and prompts from multiple servers - Container-based Servers: Run MCP servers as Docker containers with proper isolation - Secrets Management: Secure handling of API keys and credentials via Docker Desktop -- OAuth Integration: Built-in OAuth flows for service authentication - Server Catalog: Manage and configure multiple MCP catalogs -- Dynamic Discovery: Automatic tool, prompt, and resource discovery from running servers +- Dynamic Discovery and Reloading: Automatic tool, prompt, and resource discovery from running servers - Monitoring: Built-in logging and call tracing capabilities ## Install the MCP Gateway ### Prerequisites -- Docker Desktop is installed. -- The MCP Toolkit feature is [enabled](/manuals/ai/mcp-catalog-and-toolkit/toolkit.md#enable-docker-mcp-toolkit). +- [Docker Engine](/manuals/engine/_index.md) - Go 1.24+ (for development) - + ### Install as Docker CLI Plugin The MCP CLI is already installed on recent versions of Docker Desktop. From 85bdc3cccae6363a1ea7a33256e82509e7d20b98 Mon Sep 17 00:00:00 2001 From: ArthurFlag Date: Mon, 30 Jun 2025 08:55:43 +0200 Subject: [PATCH 3/4] update name --- content/manuals/ai/mcp-gateway/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/ai/mcp-gateway/_index.md b/content/manuals/ai/mcp-gateway/_index.md index 80fe2e3bd26..401e0eab03a 100644 --- a/content/manuals/ai/mcp-gateway/_index.md +++ b/content/manuals/ai/mcp-gateway/_index.md @@ -71,7 +71,7 @@ docker mcp --help ## Use the MCP Gateway -To view all the commands and configuration options, go to the [docker-mcp repository](https://github.com/docker/docker-mcp). +To view all the commands and configuration options, go to the [mcp-gateway repository](https://github.com/docker/mcp-gateway). ## Related pages From 2a48c283feabe40bc2af0a74fa3d1b8f501c23f5 Mon Sep 17 00:00:00 2001 From: ArthurFlag Date: Mon, 30 Jun 2025 15:38:16 +0200 Subject: [PATCH 4/4] install using prebuilt binaries --- content/manuals/ai/mcp-gateway/_index.md | 48 +++++++++++++++++++----- 1 file changed, 38 insertions(+), 10 deletions(-) diff --git a/content/manuals/ai/mcp-gateway/_index.md b/content/manuals/ai/mcp-gateway/_index.md index 401e0eab03a..5e6d1d339cc 100644 --- a/content/manuals/ai/mcp-gateway/_index.md +++ b/content/manuals/ai/mcp-gateway/_index.md @@ -49,19 +49,47 @@ The MCP Gateway solves problems encountered by various groups: - [Docker Engine](/manuals/engine/_index.md) - Go 1.24+ (for development) -### Install as Docker CLI Plugin +### Install using a pre-built binary -The MCP CLI is already installed on recent versions of Docker Desktop. -To update to the latest version: +> [!IMPORTANT] +> These instructions are mostly suitable for testing purposes. +> We otherwise recommend building from the sources. See the [readme](https://github.com/docker/mcp-gateway?tab=readme-ov-file#installation). -```bash -# Clone the repository -git clone https://github.com/docker/docker-mcp.git -cd docker-mcp +You can download the latest binary from the [GitHub releases page](https://github.com/docker/mcp-gateway/releases/latest). -# Build and install the plugin -make docker-mcp -``` +Rename the relevant binary and copy it to the destination matching your OS: + +| OS | Binary name | Destination folder | +|---------|---------------------|-------------------------------------| +| Linux | `docker-mcp` | `$HOME/.docker/cli-plugins` | +| macOS | `docker-mcp` | `$HOME/.docker/cli-plugins` | +| Windows | `docker-mcp.exe` | `%USERPROFILE%\.docker\cli-plugins` | + +Or copy it into one of these folders for installing it system-wide. + + +{{< tabs group="" >}} +{{< tab name="On Unix environments">}} + + +* `/usr/local/lib/docker/cli-plugins` OR `/usr/local/libexec/docker/cli-plugins` +* `/usr/lib/docker/cli-plugins` OR `/usr/libexec/docker/cli-plugins` + +> [!NOTE] +> You may have to make the binaries executable with `chmod +x`: + +> ```bash +> $ chmod +x ~/.docker/cli-plugins/docker-mcp +> ``` + +{{< /tab >}} +{{< tab name="On Windows">}} + +* `C:\ProgramData\Docker\cli-plugins` +* `C:\Program Files\Docker\cli-plugins` + +{{< /tab >}} +{{}} You can now use the `mcp` command: