MCP Gateway

MCP Gateway是一个Docker CLI插件，用于管理和部署Model Context Protocol服务器，支持与多种AI客户端集成，提供服务器管理、客户端连接、安全认证和配置备份等功能。

开发者工具虚拟化 #Docker插件 #MCP管理 #AI集成 #服务器部署 .Go

评分 : 2分

下载量 : 0

更新时间 : 2026-03-12

打开站点

什么是MCP Gateway?

MCP Gateway是一个强大的Docker命令行插件，专门用于管理Model Context Protocol (MCP)服务器。它就像一个智能管家，帮助你在Docker容器中轻松部署、配置和管理各种MCP服务器，让AI助手（如Claude、Cursor等）能够安全地访问和使用外部工具和服务。

如何使用MCP Gateway?

安装后，你可以通过简单的Docker命令来管理MCP服务器：发现可用的服务器、部署到容器、连接到AI客户端、管理安全凭证等。整个过程就像管理普通的Docker容器一样简单直观。

适用场景

适合开发者、AI工程师、数据科学家等需要在AI助手环境中集成外部工具和服务的用户。无论是想给Claude添加数据库查询能力，还是让Cursor能够访问API服务，MCP Gateway都能帮你轻松实现。

主要功能

服务器目录管理

发现、浏览和管理可用的MCP服务器，支持从OCI注册表拉取服务器镜像，轻松找到需要的工具和服务。

Docker容器化部署

将MCP服务器作为Docker容器运行，确保环境隔离、资源控制和易于管理，支持自动配置和启动。

多客户端支持

支持Claude Desktop、Cursor、VS Code、Zed等主流AI客户端，自动配置客户端连接，无需手动修改配置文件。

安全凭证管理

安全地存储和管理API密钥、访问令牌等敏感信息，支持OAuth认证流程，保护你的数据安全。

访问策略控制

定义精细的访问控制策略，限制哪些工具可以被哪些客户端访问，确保安全可控的使用环境。

配置备份恢复

备份和恢复MCP服务器的所有配置，包括目录、连接设置和安全凭证，方便迁移和灾难恢复。

优势

开箱即用：安装后即可使用，无需复杂的配置过程

容器化隔离：每个MCP服务器运行在独立的Docker容器中，互不干扰

统一管理：通过统一的Docker命令管理所有MCP服务器，学习成本低

安全可靠：内置安全机制保护敏感信息，支持访问控制策略

生态丰富：支持多种AI客户端和MCP服务器，扩展性强

局限性

依赖Docker：需要安装和运行Docker环境

学习曲线：需要了解基本的Docker和MCP概念

资源占用：每个MCP服务器都需要独立的容器资源

网络要求：某些服务器可能需要访问外部网络资源

如何使用

安装MCP Gateway

首先从源代码构建插件，然后安装到Docker CLI插件目录中。确保已安装Go语言环境和Docker。

浏览可用服务器

查看可用的MCP服务器目录，了解有哪些工具和服务可以使用。

部署MCP服务器

选择需要的MCP服务器并部署为Docker容器。系统会自动处理配置和启动。

连接到AI客户端

将部署好的MCP服务器连接到你的AI客户端，如Claude Desktop或Cursor。

配置安全凭证

为需要认证的MCP服务器设置API密钥或其他安全凭证。

使用案例

为Claude添加数据库查询能力

部署一个支持SQL查询的MCP服务器，让Claude能够直接查询数据库并获取数据。

在Cursor中集成天气API

部署天气查询MCP服务器，让Cursor在编写代码时能够获取实时天气信息。

为VS Code添加代码分析工具

部署代码质量检查MCP服务器，在VS Code中实时分析代码质量并提出改进建议。

常见问题

MCP Gateway和普通的Docker有什么区别？

我需要了解MCP协议才能使用吗？

MCP Gateway安全吗？

支持哪些AI客户端？

如何添加自定义的MCP服务器？

MCP服务器会影响我的AI助手性能吗？

🚀 MCP 网关

MCP 网关是一款 Docker CLI 插件，用于管理模型上下文协议（MCP）服务器和客户端。该工具包提供了一个全面的接口，可借助 Docker 集成来发现、部署和管理 MCP 服务器。

🚀 快速开始

MCP 网关是一款强大的命令行工具，它为 Docker CLI 扩展了 MCP 功能，能让 MCP 服务器与包括 Claude Desktop、Cursor、VS Code、Zed 等在内的各种 AI 客户端实现无缝集成。

✨ 主要特性

目录管理：发现、创建和管理 MCP 服务器目录
服务器部署：将 MCP 服务器作为 Docker 容器进行部署
客户端集成：将 MCP 服务器连接到各种 AI 桌面客户端
密钥管理：安全地管理凭证和密钥
OAuth 支持：处理 OAuth 认证流程
策略管理：定义并执行访问策略
备份与恢复：备份和恢复 MCP 配置
OCI 注册表支持：从 OCI 注册表拉取和推送 MCP 服务器镜像

📦 安装指南

前提条件

Go 1.25.5 或更高版本
Docker CLI
Docker 引擎

从源代码构建

# 克隆仓库
git clone https://github.com/kawai-network/mcp-gateway.git
cd mcp-gateway

# 构建插件
go build -o docker-mcp ./cmd/docker-mcp

# 作为 Docker CLI 插件安装
mkdir -p ~/.docker/cli-plugins
cp docker-mcp ~/.docker/cli-plugins/docker-mcp
chmod +x ~/.docker/cli-plugins/docker-mcp

💻 使用示例

基础命令

# 显示帮助信息
docker mcp --help

# 显示版本信息
docker mcp version

# 列出可用命令
docker mcp --help

目录管理

# 列出可用的 MCP 服务器
docker mcp catalog ls

# 显示特定服务器的详细信息
docker mcp catalog show <server-name>

# 创建新的目录条目
docker mcp catalog create <name> --image <image>

# 向目录中添加服务器
docker mcp catalog add <name>

# 从目录中移除服务器
docker mcp catalog rm <name>

# 导出目录
docker mcp catalog export <output-file>

# 导入目录
docker mcp catalog import <input-file>

服务器管理

# 列出已部署的服务器
docker mcp server ls

# 初始化新服务器
docker mcp server init <name>

# 启用服务器
docker mcp server enable <name>

# 检查服务器配置
docker mcp server inspect <name>

客户端管理

# 列出已连接的客户端
docker mcp client ls

# 将客户端连接到 MCP 服务器
docker mcp client connect <client> <server>

# 断开客户端连接
docker mcp client disconnect <client> <server>

工具管理

# 列出可用工具
docker mcp tools list

# 调用工具
docker mcp tools call <tool-name>

# 启动工具
docker mcp tools start <tool-name>

密钥管理

# 列出密钥
docker mcp secret ls

# 设置密钥
docker mcp secret set <name> <value>

# 移除密钥
docker mcp secret rm <name>

# 导出密钥
docker mcp secret export <output-file>

OAuth 管理

# 列出 OAuth 令牌
docker mcp oauth ls

# 进行认证
docker mcp oauth auth

# 撤销令牌
docker mcp oauth revoke <token-id>

策略管理

# 转储策略配置
docker mcp policy dump

# 设置策略
docker mcp policy set <policy-file>

备份与恢复

# 备份配置
docker mcp backup dump <output-file>

# 恢复配置
docker mcp backup restore <input-file>

📚 详细文档

支持的客户端

MCP 网关支持与以下 AI 桌面客户端集成：

Claude Desktop - Anthropic 的 Claude AI 助手
Cursor - 由 AI 驱动的代码编辑器
VS Code - 微软的 Visual Studio Code
Zed - 高性能代码编辑器
Kiro - AI 开发环境
Continue.dev - AI 结对编程扩展

配置

客户端配置文件

该工具会自动检测并管理受支持应用程序的客户端配置文件。配置文件存储在以下标准位置：

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
Cursor：~/.cursor/mcp.json
VS Code：~/.vscode/mcp.json
Zed：~/.config/zed/settings.jsonc
Continue.dev：~/.continue/config.json

目录配置

目录以 YAML 格式定义：

name: my-mcp-server
description: My custom MCP server
image: my-registry/my-mcp-server:latest
tools:
  - name: tool1
    description: First tool
  - name: tool2
    description: Second tool

开发

项目结构

mcp-gateway/
├── cmd/docker-mcp/       # 主 CLI 应用程序
│   ├── commands/          # 命令实现
│   ├── catalog/           # 目录管理
│   ├── client/            # 客户端集成
│   ├── oauth/             # OAuth 处理
│   ├── secret-management/ # 密钥管理
│   └── server/            # 服务器管理
├── catalog/               # 目录核心逻辑
├── catalog_next/          # 下一代目录（基于 OCI）
├── client/                # 客户端配置文件管理
├── codemode/              # 代码模式功能
├── config/                # 配置处理
├── db/                    # 数据库层
├── desktop/               # 桌面集成
├── docker/                # Docker 客户端包装器
├── features/              # 功能标志
├── migrate/               # 数据库迁移
├── signatures/            # 签名验证
└── version/               # 版本信息

运行测试

# 运行所有测试
go test ./...

# 运行带覆盖率的测试
go test -cover ./...

# 运行特定包的测试
go test ./cmd/docker-mcp/commands

构建

# 为当前平台构建
go build -o docker-mcp ./cmd/docker-mcp

# 为多个平台构建
GOOS=linux GOARCH=amd64 go build -o docker-mcp-linux-amd64 ./cmd/docker-mcp
GOOS=darwin GOARCH=amd64 go build -o docker-mcp-darwin-amd64 ./cmd/docker-mcp
GOOS=darwin GOARCH=arm64 go build -o docker-mcp-darwin-arm64 ./cmd/docker-mcp