Microsoft MCP Gateway

MCP Gateway

**MCP Gateway** is a reverse proxy and management layer for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) servers, enabling scalable, session-aware routing, authorization and lifecycle management of MCP servers in Kubernetes environments.

Table of Contents

• Overview
• Key Concepts
• Architecture
• Features
• Getting Started – Local Deployment
• Getting Started – 1-Click Deploy to Azure

Overview

This project provides:

• A data gateway for routing traffic to MCP servers with session affinity.
• A control plane for managing the MCP server lifecycle (deploy, update, delete).
• Enterprise-ready integration points including telemetry, access control and observability.

Key Concepts

• MCP Server: A server implementing the Model Context Protocol, which typically a streamable HTTP endpoint.
• Adapters: Logical resources representing MCP servers in the gateway, managed under the /adapters scope. Designed to coexist with other resource types (e.g., /agents) in a unified AI development platform.
• Tools: Registered resources with MCP tool definitions that can be dynamically routed via the tool gateway router. Each tool includes metadata about its execution endpoint and input schema.
• Tool Gateway Router: An MCP server that acts as an intelligent router, directing tool execution requests to the appropriate registered tool servers based on tool definitions. Multiple router instances may run behind the gateway for session affinity.
• Session-Aware Stateful Routing: Ensures that all requests with a given session_id are consistently routed to the same MCP server instance.

Architecture

flowchart LR
    subgraph Clients[" "]
        direction TB
        DataClient["🔌 Agent/MCP
Data Client"]
        MgmtClient["⚙️ Management
Client"]
    end


...