How microsoft/mcp-gateway works
MCP Gateway combines a Kubernetes-backed control plane with a stateless MCP data plane: clients manage adapter/tool resources or send independent MCP requests, which are authorized and routed to running servers. The portal is a management client; optional agent sessions add Foundry-backed runs and SSE events. Edges are limited to relationships shown in excerpts, SOURCE INDEX references, or README claims; several unsampled controller and agent internals are therefore represented at subsystem level.
Main entry points: Program.cs Gateway host · AdapterReverseProxyController.cs Adapter MCP route · KubernetesAdapterDeploymentManager.cs Kubernetes deployment · AdapterManagementService.cs Adapter lifecycle
Components 25
Gateway service
- Gateway host
dotnet/Microsoft.McpGateway.Service/src/Program.cs - Adapter MCP route
dotnet/Microsoft.McpGateway.Service/src/Controllers/AdapterReverseProxyController.cs
Management plane
- Access control
dotnet/Microsoft.McpGateway.Management/src/Authorization - Adapter management
dotnet/Microsoft.McpGateway.Service/src/Controllers/ManagementController.cs - Tool management
dotnet/Microsoft.McpGateway.Service/src/Controllers/ToolManagementController.cs - Adapter lifecycle
dotnet/Microsoft.McpGateway.Management/src/Service/AdapterManagementService.cs - Tool lifecycle
dotnet/Microsoft.McpGateway.Management/src/Service/ToolManagementService.cs - Kubernetes deployment
dotnet/Microsoft.McpGateway.Management/src/Deployment/KubernetesAdapterDeploymentManager.cs - Kubernetes API wrapper
dotnet/Microsoft.McpGateway.Management/src/Deployment/KubeClient.cs - Adapter metadata
dotnet/Microsoft.McpGateway.Management/src/Store - Tool metadata
dotnet/Microsoft.McpGateway.Management/src/Store
MCP execution
- Tool MCP router
dotnet/Microsoft.McpGateway.Tools/src/Program.cs - Tool definition provider
dotnet/Microsoft.McpGateway.Tools/src/Services/StorageToolDefinitionProvider.cs - HTTP tool executor
dotnet/Microsoft.McpGateway.Tools/src/Services/HttpToolExecutor.cs
Agents and sessions
- Agent management
dotnet/Microsoft.McpGateway.Service/src/Controllers/AgentManagementController.cs - Session endpoints
dotnet/Microsoft.McpGateway.Service/src/Controllers/SessionManagementController.cs - Session orchestration
dotnet/Microsoft.McpGateway.Management/src/Service/SessionManagementService.cs - Agent runner
dotnet/Microsoft.McpGateway.Management/src/Foundry/AgentRunner.cs - Foundry chat client
dotnet/Microsoft.McpGateway.Management/src/Foundry/FoundryChatClient.cs
Management portal
- Portal screens
portal/src/App.tsx - Portal API client
portal/src/api/client.ts
Other components
- MCP client
- Management client
- Adapter instances
- Tool servers
Connections 29
- MCP client → Gateway host: sends MCP
README.md - Management client → Gateway host: calls APIs
README.md - Gateway host → Adapter MCP route: routes adapter
dotnet/Microsoft.McpGateway.Service/src/Program.cs - Gateway host → Tool MCP router: maps MCP
dotnet/Microsoft.McpGateway.Tools/src/Program.cs - Adapter MCP route → Adapter metadata: reads metadata
dotnet/Microsoft.McpGateway.Service/src/Controllers/AdapterReverseProxyController.cs - Adapter MCP route → Access control: checks access
dotnet/Microsoft.McpGateway.Service/src/Controllers/AdapterReverseProxyController.cs - Adapter MCP route → Adapter instances: proxies requests
README.md - Gateway host → Adapter management: serves management
README.md - Gateway host → Tool management: serves management
README.md - Adapter management → Adapter lifecycle: invokes lifecycle
- Tool management → Tool lifecycle: invokes lifecycle
- Adapter lifecycle → Kubernetes deployment: deploys resources
- Tool lifecycle → Kubernetes deployment: deploys resources
dotnet/Microsoft.McpGateway.Management/src/Service/ToolManagementService.cs - Kubernetes deployment → Kubernetes API wrapper: applies workloads
dotnet/Microsoft.McpGateway.Management/src/Deployment/KubernetesAdapterDeploymentManager.cs - Adapter lifecycle → Adapter metadata: persists metadata
- Tool lifecycle → Tool metadata: persists metadata
dotnet/Microsoft.McpGateway.Management/src/Service/ToolManagementService.cs - Kubernetes deployment → Adapter instances: manages workloads
README.md - Tool MCP router → Tool definition provider: loads definitions
dotnet/Microsoft.McpGateway.Tools/src/Program.cs - Tool definition provider → Tool metadata: reads definitions
dotnet/Microsoft.McpGateway.Tools/src/Services/StorageToolDefinitionProvider.cs - Tool MCP router → HTTP tool executor: dispatches tools
dotnet/Microsoft.McpGateway.Tools/src/Program.cs - HTTP tool executor → Tool servers: executes remotely
README.md - Management client → Portal screens: uses portal
README.md - Portal screens → Portal API client: requests data
portal/src/App.tsx - Portal API client → Gateway host: calls gateway
README.md - Gateway host → Agent management: serves preview APIs
README.md - Gateway host → Session endpoints: serves preview APIs
README.md - Session endpoints → Session orchestration: delegates sessions
dotnet/Microsoft.McpGateway.Service/src/Controllers/SessionManagementController.cs - Session orchestration → Agent runner: streams agent run
dotnet/Microsoft.McpGateway.Management/src/Service/SessionManagementService.cs - Agent runner → Foundry chat client: uses chat model