← 返回目录

Docker MCP Gateway

官方

网关 / 代理

Docker 官方的 MCP 网关 CLI 插件，用于管理和运行 MCP 服务器。

这是聚合或代理其他 MCP Server 的网关，需要再接入具体的 Server 才有实际能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 20 / 438
Stars: ★ 1.6k 非常热门
传输方式: stdio（本地进程）
运行环境: Docker 4.59+ · Go 1.24+
凭据: 可选 API Key
许可证: MIT
最近提交: 26 天前

68FMRS · C

Docker MCP Gateway 是一个强大的工具，适合依赖 Docker 的开发者。它提供了统一的管理接口，但要求 Docker Desktop 和一定的学习成本。

最强项 · 维护活跃度 18/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

18/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 10/20: 该仓库包含一个简单的服务器清单示例（server.json），其结构与README中的描述相符。由于是静态审查，无法验证实际执行。README和清单声明了多种功能，但缺乏可重复的测试证据（如单元测试或集成测试）来覆盖关键路径。因此，可靠性评分上限为10。
安全与权限 15/20: 清单未定义任何危险操作或权限提升。服务器仅配置了环境变量和密钥引用，这些是运行时由用户提供的。README强调了Docker容器隔离和密钥管理。没有发现恶意行为或越权请求的迹象。虽然无法验证安全实践是否充分，但未触发任何红线。因此，安全评分较高，但由于缺乏详细的安全审计证据，未达到满分。
维护活跃度 18/20: 该仓库由Docker官方维护，拥有MIT许可证，近期有活跃的提交和发布。有113个未解决的问题，但问题响应和更新路径看起来良好。CI工作流存在，表明持续集成。因此，维护评分较高，但未达到满分，因为发布/版本策略和问题响应时间的详细证据有限。
文档质量 14/20: README非常全面，涵盖安装、用法、配置、架构和故障排除。它提供了丰富的命令示例和指向详细文档的链接。服务器清单有基本描述。但仍有不足之处，例如缺少特定工具参数的完整文档，以及环境变量和依赖项的详细说明。因此，文档评分良好但未达满分。
安装易用性 11/20: 安装说明清晰，但需要Docker Desktop 4.59+，并建议使用Makefile构建。作为一个CLI插件，命令示例详细。然而，静态审查无法验证安装步骤，且涉及多个组件（Docker Desktop、Go环境、MCP Toolkit），增加了复杂性。因此，安装评分中等，高于10但未达到15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

使用 Docker Desktop 的开发者，希望简化 MCP 服务器部署和管理。
需要在一个网关下管理多个 MCP 服务器，并统一配置和监控。
需要在容器化环境中运行 MCP 服务器，以降低主机权限风险。

不适合谁

不使用 Docker 的开发者。
需要直接运行本地 npx 或 uvx 服务器而无需容器化的场景。
需要与 Docker Desktop 无关的轻量级 MCP 客户端。

所需权限

需要 Docker 守护进程访问权限，以运行和管理容器。
读取和写入本地配置文件（如 ~/.docker/config.json）。
访问 Docker Desktop 的密钥管理功能以存储秘密。
可能启动 OAuth 流程，需要网络访问。

风险与副作用

容器映像可能包含恶意代码，运行不信任的 MCP 服务器时需谨慎。
秘密管理不当可能泄露 API 密钥。
网关的配置错误可能导致客户端连接失败或工具访问错误。
由于依赖 Docker Desktop 和 CLI 插件，版本兼容性问题可能存在。

安装接入

准备工作

运行环境：Docker 4.59+ · Go 1.24+

其他可选配置项（2 个）

DOCKER_MCP_IN_CONTAINER 可选设为 1 可绕过 Docker Desktop 功能检查，用于 WSL2、容器化环境或 Docker CE；无需获取。

CLAUDE_CONFIG_DIR 可选覆盖 Claude Code 默认配置目录（~/.claude），用于隔离多套配置；可选设置。

确保已安装 Docker Desktop 4.59+ 并启用 MCP Toolkit 功能。\n2. 克隆仓库：git clone https://github.com/docker/mcp-gateway.git\n3. 进入目录：cd mcp-gateway\n4. 创建 CLI 插件目录：mkdir -p ~/.docker/cli-plugins/\n5. 构建并安装插件：make docker-mcp\n6. 验证安装：docker mcp --help

验证是否装好

运行 docker mcp gateway run 启动网关，然后在客户端工具列表中确认已发现服务器的工具（如 github 服务器的工具），或执行 docker mcp tools ls 验证工具已被发现。

常见排障

如果遇到 'Docker Desktop is not running' 错误，可设置环境变量 DOCKER_MCP_IN_CONTAINER=1。
确保在独立环境中已启用 profiles 功能：docker mcp feature enable profiles。
检查 Docker 守护进程是否运行，以及 CLI 插件是否正确安装。
查看文档中的故障排除指南：docs/troubleshooting.md。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前 MCP gateway 中所有可用的工具
调用 github 服务器的 create_issue 工具创建一个 issue
查看 github.list_repos 工具的详细说明
通过 gateway 列出我的 GitHub 仓库

使用场景

在 Docker 环境中统一管理和运行多个 MCP 服务器。

为 AI 客户端（如 VS Code、Cursor、Claude Desktop）提供一致的 MCP 配置。

通过 OAuth 和秘密管理安全地集成需要身份验证的 MCP 服务。

详细介绍

Docker MCP Gateway 是一个 Docker CLI 插件，作为 MCP 客户端与多个 MCP 服务器之间的统一网关。它管理 MCP 服务器的生命周期，提供统一的接口，处理认证和安全性，支持动态工具发现和 OAuth 流。服务器以 Docker 容器运行，实现隔离。