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