docker/mcp-gateway

Docker MCP Gateway 中文技术文档

1. 镜像概述和主要用途

MCP Gateway 是一款为代理（Agents）设计的 MCP（Modular Component Protocol）网关服务，作为 MCP 服务与代理之间的中间层，负责处理连接管理、协议转换、配置与密钥管理等核心功能，支持多场景下的 MCP 服务代理与集成。

2. 核心功能与特性

• 多部署模式支持：兼容容器化部署、Docker Compose 集成、Docker-in-Docker 环境等多种部署方式。
• 配置与密钥管理：支持通过配置文件、环境变量（如 .env 文件）管理服务配置及敏感密钥。
• 远程 MCP 代理：可作为中间层代理远程 MCP 服务器，实现跨网络的 MCP 服务访问。
• 健康检查机制：集成健康检查功能，支持 Docker Compose 健康状态监控。
• 拦截器支持：允许配置工具调用（Tool Calls）拦截器，实现请求过滤或自定义处理逻辑。
• 多服务集成：支持与 PostgreSQL 等数据库、MCP Toolkit 等工具集成，扩展业务场景。
• 静态模式部署：提供实验性的 static 模式，通过 Docker Compose 实现静态部署。

3. 使用场景与适用范围

适用场景

• 容器化环境中部署 MCP 网关，作为 MCP 服务与代理的中间层。
• 需代理远程 MCP 服务器的跨网络访问场景。
• 开发/测试环境中快速搭建 MCP 网关及配套服务（如数据库查询代理）。
• 生产环境中需健康检查、密钥管理的 MCP 服务部署。
• 通过 MCP Toolkit 实现配置与密钥的自动化管理。

适用范围

• 需要 MCP 协议代理的应用系统。
• 微服务架构中需 MCP 中间层的服务集群。
• 开发、测试及生产环境的 MCP 网关部署需求。

4. 使用方法与部署示例

4.1 Docker 容器部署（基础模式）

通过 docker run 命令直接在容器中运行 MCP Gateway：

bash
# 基础容器部署（无额外配置，参考 examples/container）
docker run -d --name mcp-gateway docker/mcp-gateway:latest

4.2 Docker Compose 部署

4.2.1 最简 Compose 配置（无配置/密钥）

参考 minimal-compose 示例，仅部署单个 MCP Server，不包含额外配置：

yaml
# docker-compose.yml
version: '3.8'
services:
  mcp-gateway:
    image: docker/mcp-gateway:latest
    ports:
      - "8080:8080"  # 默认端口映射

启动命令：

bash
docker-compose up -d

4.2.2 带配置与密钥的 Compose 配置

参考 config 和 secrets 示例，通过配置文件和 .env 管理密钥：

yaml
# docker-compose.yml
version: '3.8'
services:
  mcp-gateway:
    image: docker/mcp-gateway:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config:/app/config  # 挂载配置文件目录
    env_file:
      - .env  # 加载密钥环境变量

创建 .env 文件存储密钥：

env
# .env
MCP_SECRET_KEY=your-secret-key-here
MCP_SERVER_URL=http://mcp-server:8081  # MCP 服务器地址

启动命令：

bash
docker-compose up -d

5. 配置说明

5.1 环境变量

5.2 配置文件

配置文件通常挂载至容器内 /app/config 目录，支持 JSON/YAML 格式，用于定义拦截器规则、服务路由等高级配置（具体格式参考 interceptors 示例）。

6. 示例场景详解

7. 源码与参考

• 源码地址：https://github.com/docker/mcp-gateway
• 示例详情：参见源码仓库 examples 目录下各场景具体配置及说明。