모델 컨텍스트 프로토콜(MCP) 서버를 위한 Envoy 기반 게이트웨이로, 단일 엔드포인트 뒤에 여러 MCP 서버를 집계하고 라우팅할 수 있게 합니다.

비전

프로젝트 비전과 설계 원칙은 VISION.md 를 참조하세요.

건축

기술 아키텍처에 대해서는 docs/design/overview.md를 참고하세요.

빠른 설치

최소 설치 (자체 인프라 가져오기)

이미 게이트웨이 API가 설치된 Kubernetes 클러스터가 있다면, MCP 게이트웨이 컴포넌트만 설치하세요:

이 과정에서 설치되는 것:

• MCP 게이트웨이 CRD
• 브로커/라우터 배포
• 컨트롤러 배치
• RBAC 자료

자세한 내용과 전제 조건은 config/install/README.md를 참조하세요.

개발 환경

모든 의존성을 갖춘 완전한 로컬 환경을 위해(Istio, Gateway API, Keycloak, 모든 테스트 서버):

이로 인해 다음과 같은 상황이 시작됩니다:

• kind 클러스터
• 게이트웨이 API 제공자로서의 Istio
• MCP 게이트웨이 구성 요소 (브로커 / 라우터 / 컨트롤러)
• 모든 테스트 서버
• 예시 MCPServerRegistration

모든 테스트 서버를 배포하려면 설정 후 make deploy-test-servers를 실행하세요.

e2e 테스트 추가

e2e 테스트를 추가하실 경우, 제공된 claude slash 명령어를 사용해 주세요: e2e 명령어.

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.