MCP Gateway

MCPゲートウェイは、Model Context Protocolサーバーを管理およびデプロイするためのDocker CLIプラグインで、複数のAIクライアントと統合をサポートし、サーバー管理、クライアント接続、セキュリティ認証、構成バックアップなどの機能を提供します。

開発者ツール仮想化 #Dockerプラグイン #MCP管理 #AI統合 #サーバーデプロイ .Go

スコア : 2ポイント

ダウンロード数 : 6.5K

更新時間 : 2026-03-12

サイトを開く

MCPゲートウェイとは？

MCPゲートウェイは、Model Context Protocol (MCP)サーバーを管理するために特別に設計された強力なDockerコマンドラインプラグインです。これは、Dockerコンテナ内でさまざまなMCPサーバーを簡単にデプロイ、構成、管理するためのスマートなマネージャーのような存在で、AIアシスタント（ClaudeやCursorなど）が外部のツールやサービスに安全にアクセスして使用できるようにします。

MCPゲートウェイの使い方は？

インストール後、簡単なDockerコマンドを使用してMCPサーバーを管理できます。利用可能なサーバーの検索、コンテナへのデプロイ、AIクライアントへの接続、セキュリティ資格情報の管理など。全体的なプロセスは、通常のDockerコンテナの管理と同じくらい簡単で直感的です。

適用シナリオ

AIアシスタント環境で外部ツールやサービスを統合する必要のある開発者、AIエンジニア、データサイエンティストなどのユーザーに適しています。Claudeにデータベースクエリ機能を追加したい場合でも、CursorがAPIサービスにアクセスできるようにしたい場合でも、MCPゲートウェイが簡単に実現できます。

主要機能

サーバーカタログ管理

利用可能な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ゲートウェイのインストール

まず、ソースコードからプラグインをビルドし、Docker CLIプラグインディレクトリにインストールします。Go言語環境とDockerがインストールされていることを確認してください。

利用可能なサーバーの閲覧

利用可能なMCPサーバーのカタログを表示し、どのツールやサービスが利用できるかを確認します。

MCPサーバーのデプロイ

必要なMCPサーバーを選択し、Dockerコンテナとしてデプロイします。システムが自動的に構成と起動を処理します。

AIクライアントへの接続

デプロイしたMCPサーバーをClaude DesktopやCursorなどのAIクライアントに接続します。

セキュリティ資格情報の構成

認証が必要なMCPサーバーにAPIキーまたはその他のセキュリティ資格情報を設定します。

使用例

Claudeにデータベースクエリ機能を追加する

SQLクエリをサポートするMCPサーバーをデプロイし、Claudeが直接データベースをクエリしてデータを取得できるようにします。

Cursorに天気APIを統合する

天気クエリ用のMCPサーバーをデプロイし、Cursorがコードを記述する際にリアルタイムの天気情報を取得できるようにします。

VS Codeにコード分析ツールを追加する

コード品質チェック用のMCPサーバーをデプロイし、VS Codeでコード品質をリアルタイムに分析し、改善提案を提供します。

よくある質問

MCPゲートウェイと通常のDockerの違いは何ですか？

MCPプロトコルを理解する必要がありますか？

MCPゲートウェイは安全ですか？

どのAIクライアントをサポートしていますか？

カスタムのMCPサーバーを追加するにはどうすればいいですか？

MCPサーバーはAIアシスタントのパフォーマンスに影響しますか？

🚀 MCP Gateway

Model Context Protocol (MCP) サーバーとクライアントを管理するための Docker CLI プラグインです。このツールキットは、Docker との統合を通じて、MCP サーバーの検出、デプロイ、管理を行う包括的なインターフェースを提供します。

🚀 クイックスタート

MCP Gateway は、Docker CLI に MCP 機能を拡張する強力なコマンドラインツールです。Claude Desktop、Cursor、VS Code、Zed などのさまざまな AI クライアントと MCP サーバーをシームレスに統合できます。

✨ 主な機能

カタログ管理：MCP サーバーのカタログを検出、作成、管理します。
サーバーデプロイ：MCP サーバーを Docker コンテナとしてデプロイします。
クライアント統合：MCP サーバーをさまざまな AI デスクトップクライアントに接続します。
シークレット管理：資格情報とシークレットを安全に管理します。
OAuth サポート：OAuth 認証フローを処理します。
ポリシー管理：アクセスポリシーを定義し、強制します。
バックアップと復元：MCP 設定をバックアップし、復元します。
OCI レジストリサポート：OCI レジストリから MCP サーバーイメージをプルし、プッシュします。

📦 インストール

前提条件

Go 1.25.5 以上
Docker CLI
Docker Engine

ソースからのビルド

# リポジトリをクローンする
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 Gateway は、以下の AI デスクトップクライアントとの統合をサポートしています。

Claude Desktop - Anthropic の Claude AI アシスタント
Cursor - AI 駆動のコードエディター
VS Code - Microsoft 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