モデルコンテキストプロトコル(MCP)サーバー向けのEnvoyベースのゲートウェイで、複数のMCPサーバーを単一のエンドポイントの背後で集約・ルーティングできるようにします。

ビジョン

プロジェクトのビジョンと設計原則については VISION.md を参照してください。

建築

技術アーキテクチャについてはdocs/design/overview.mdを参照してください。

クイックインストール

最小限のインストール(自分でインフラを持参)

すでにGateway APIを搭載したKubernetesクラスターがある場合は、MCPゲートウェイコンポーネントのみをインストールしてください。

これにより、以下のことがインストールされます:

• MCPゲートウェイCRD
• ブローカー/ルーター展開
• コントローラー展開
• RBACリソース

詳細や前提条件はconfig/install/README.mdを参照してください。

開発環境

すべての依存関係を持つ完全なローカル環境(Istio、Gateway API、Keycloak、すべてのテストサーバー)を用意するために:

これにより、次のような展開が始まります。

• kindクラスター
• Istio はゲートウェイAPIプロバイダーとして提供されています
• MCPゲートウェイコンポーネント(ブローカー/ルーター/コントローラ)
• エブリシングテストサーバー
• 例 MCPServerRegistration(例:MCPServerRegistration)

すべてのテストサーバーを展開するには、セットアップ後にmake deploy-test-serversを実行します。

e2eテストの追加

もしe2eテストを追加する場合は、提供されているclaude slashコマンド : e2e command の使用を検討してください。

MCP Gateway

An Envoy-based gateway for Model Context Protocol (MCP) servers, enabling aggregation and routing of multiple MCP servers behind a single endpoint.

Vision

See VISION.md for project vision and design principles.

Architecture

See docs/design/overview.md for technical architecture.

Quick Install

Minimal Installation (bring your own infrastructure)

If you already have a Kubernetes cluster with Gateway API installed, install just the MCP Gateway components:

# Install Gateway API CRDs
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.4.1/standard-install.yaml
# Install MCP Gateway (quotes required for zsh)
kubectl apply -k 'https://github.com/Kuadrant/mcp-gateway/config/install?ref=main'

This installs:

• MCP gateway CRDs
• Broker/router deployment
• Controller deployment
• RBAC resources

See config/install/README.md for details and prerequisites.

Development Environment

For a complete local environment with all dependencies (Istio, Gateway API, Keycloak, everything test server):

make local-env-setup

This sets up:

• a kind cluster
• Istio as a Gateway API provider
• MCP Gateway components (Broker / Router / Controller)
• the everything test server
• example MCPServerRegistration

To deploy all test servers, run make deploy-test-servers after setup.

Adding e2e tests

If you are adding an e2e test, please consider using the claude slash command provided : e2e command. You can of course still add them manually if you prefer.

Quick start with MCP Inspector

Set up a local kind cluster with the Broker, Router & Controller running. These components are built during the make target into a single image and loaded into the cluster. Also sets up an Istio Gateway API Gateway with the everything test server behind the broker/router.

make local-env-setup

# Or with custom ports (defaults: 8001->30080->8080 for MCP Broker/Gateway, 8002->30081->8002 for Keycloak)
KIND_HOST_PORT_MCP_GATEWAY=8090 KIND_HOST_PORT_KEYCLOAK=8453 make local-env-setup

Note: If you change these ports, be mindful that some examples or YAML resources may need to be updated manually to use the updated port. You should check for anything that connects to mcp.127-0-0-1.sslip.io or keycloak.127-0-0-1.sslip.io and update the port numbers accordingly.