一、項目定位與核心價值

MCP（Model Context Protocol）Gateway 是面向 Kubernetes 環境的反向代理與管理層，專為 會話感知的路由 與 MCP 實例生命周期管理 設計。它兼具 數據平面（流量轉發）和 控制平面（部署、運維、監控）功能，為多實例的模型服務提供統一入口，解決了會話粘性、彈性伸縮、企業安全等關鍵痛點。

二、關鍵能力

• MCP Server：實現 Model Context Protocol 的后端服務（如 SSE、流式 HTTP）。
• Adapters：在 /adapters 路徑下注冊的邏輯資源，代表各 MCP 實例，可與其他資源（如 /agents）共存。
• Session?Aware Routing：確保同一會話始終使用同一后端實例，實現狀態保持。

四、控制平面 API（示例）

五、數據平面路由（示例）

• GET /adapters/{name}/sse – Server?Sent Events
• POST /adapters/{name}/messages – 基于會話的消息投遞
• POST /adapters/{name}/mcp – 流式 HTTP 接口

這些接口均通過 Session?Aware Routing 自動將請求路由到對應的 MCP 實例。

六、項目結構概覽

mcp-gateway/
 ├─ dotnet/                     # 主網關服務 (.NET 8)
 │   ├─ Microsoft.McpGateway.Service/
 │   └─ Microsoft.McpGateway.Management/
 ├─ mcp-example-server/        # 示例 MCP 服務器
├─ deployment/
 │   ├─ infra/azure-deployment.bicep
 │   └─ k8s/                    # K8s manifests
 ├─ openapi/                    # OpenAPI 3.0 規范
└─ workflows/                  # CI/CD

• 技術棧：.NET?8 + ASP.NET Core、Docker、Kubernetes、分布式內存存儲、Bearer Token + RBAC、Azure + Bicep。
• 部署方式：本地 Docker Desktop + 本地 K8s；或 Azure AKS + 企業安全配置。

七、快速入門路徑

1. Quick Start – 首次部署，獲取完整的示例與默認配置。
2. Local Development Setup – 本地環境（Docker + K8s）搭建，便于調試。
3. Azure Cloud Deployment – 使用 Azure Bicep 腳本在 AKS 上部署生產環境。
4. VS Code Integration – 與 VS Code 交互式測試，實時查看路由與日志。

八、使用場景與優勢

• 多模型服務統一入口：在同一集群內運行多個模型實例，Gateway 自動實現會話粘性。
• 彈性伸縮：基于 Kubernetes 的水平擴展，流量高峰時自動擴容。
• 企業安全：統一的鑒權與審計，滿足合規要求。
• 可觀測性：統一日志、指標、追蹤，便于運維與故障排查。

九、結語

MCP Gateway 為構建 可擴展、會話感知、企業級安全 的模型服務平臺提供了完整的技術方案。通過 .NET?8 與 Kubernetes 的深度結合，它實現了從 本地開發 到 云端生產 的全鏈路支持，幫助開發者專注于模型本身，而將路由、管理、監控等基礎設施交給 Gateway 統一處理。