add MCP Gateway #22935
+117
−2
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,106 @@ | ||||||
| --- | ||||||
| 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 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: | ||||||
|
|
||||||
| - 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, | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| and access control for all MCP servers. | ||||||
| - Enterprise Observability: Built-in monitoring, logging, and filtering tools ensure | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| 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 | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| 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 | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - Container-based Servers: Run MCP servers as Docker containers with proper isolation | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - Secrets Management: Secure handling of API keys and credentials via Docker Desktop | ||||||
ArthurFlag marked this conversation as resolved.
Show resolved
Hide resolved
There was a problem hiding this comment.
Suggested change
|
||||||
| - Server Catalog: Manage and configure multiple MCP catalogs | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - Dynamic Discovery and Reloading: Automatic tool, prompt, and resource discovery from running servers | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
| - Monitoring: Built-in logging and call tracing capabilities | ||||||
|
|
||||||
| ## Install the MCP Gateway | ||||||
|
|
||||||
| ### Prerequisites | ||||||
|
|
||||||
| - [Docker Engine](/manuals/engine/_index.md) | ||||||
| - Go 1.24+ (for development) | ||||||
|
|
||||||
| ### Install using a pre-built binary | ||||||
|
|
||||||
| > [!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). | ||||||
|
Check failure on line 56 in content/manuals/ai/mcp-gateway/_index.md
|
||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| You can download the latest binary from the [GitHub releases page](https://github.com/docker/mcp-gateway/releases/latest). | ||||||
|
|
||||||
| 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. | ||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
|
|
||||||
| {{< tabs group="" >}} | ||||||
| {{< tab name="On Unix environments">}} | ||||||
|
|
||||||
|
|
||||||
| * `/usr/local/lib/docker/cli-plugins` OR `/usr/local/libexec/docker/cli-plugins` | ||||||
|
Check warning on line 75 in content/manuals/ai/mcp-gateway/_index.md
|
||||||
| * `/usr/lib/docker/cli-plugins` OR `/usr/libexec/docker/cli-plugins` | ||||||
|
Check warning on line 76 in content/manuals/ai/mcp-gateway/_index.md
|
||||||
|
|
||||||
| > [!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 >}} | ||||||
| {{</tabs >}} | ||||||
|
|
||||||
| 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 [mcp-gateway repository](https://github.com/docker/mcp-gateway). | ||||||
|
|
||||||
| ## Related pages | ||||||
|
|
||||||
| - [Docker MCP toolkit and catalog](/manuals/ai/mcp-catalog-and-toolkit/_index.md) | ||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.