Шлюз на базе Envoy для серверов Model Context Protocol (MCP), позволяющий агрегировать и маршрутизировать несколько MCP-серверов за одной конечной точкой.

Видение

См. VISION.md для видения проекта и принципов проектирования.

Архитектура

См. docs/design/overview.md для технической архитектуры.

Быстрая установка

Минимальная установка (принесите свою инфраструктуру)

Если у вас уже есть кластер Kubernetes с установленным Gateway API, установите только компоненты MCP Gateway:

Это устанавливает:

• MCP-шлюзовые CRD
• Развертывание брокера/маршрутизатора
• Развертывание контроллеров
• Ресурсы RBAC

См. config/install/README.md для подробностей и требований.

Среда развития

Для полной локальной среды со всеми зависимостями (Istio, Gateway API, Keycloak, сервер тестирования всего):

Это создаёт:

• кластер kind
• Istio как провайдер Gateway API
• Компоненты шлюза 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.