KMCP研讨会:在Kubernetes上构建和部署MCP服务器
欢迎来到 KMCP工作坊!本实践研讨会将指导您使用以下工具构建和部署模型上下文协议(MCP)服务器 kmcp -用于管理MCP服务器的Kubernetes原生框架。
🎯 工作坊概述
在本次工作坊中,您将学习如何:
- 设置KMCP CLI和本地Kubernetes环境
- 使用FastMCP Python创建您的第一个MCP服务器
- 使用真实世界的示例开发自定义MCP工具
- 安全地管理机密和环境变量
- 将MCP服务器部署到Kubernetes集群
- 使用MCP检查器测试和验证您的MCP服务器
📚 什么是KMCP?
KMCP(Kubernetes模型上下文协议) 是一个简化Kubernetes环境中MCP服务器开发和部署的框架。它提供:
- CLI工具 用于搭建、构建和部署MCP服务器
- 控制器管理器 用于管理Kubernetes中的MCP服务器生命周期
- 内建支持 适用于FastMCP Python和MCP Go框架
- 秘密管理 用于安全的环境变量处理
🎓 学习目标
在本次研讨会结束时,您将:
- 了解MCP(模型上下文协议)架构
- 在本地创建并运行MCP服务器
- 构建扩展AI代理功能的自定义工具
- 将MCP服务器部署到Kubernetes集群
- 管理生产环境中的机密和配置
- 使用MCP检查器测试和调试MCP服务器
📋 先决条件
在开始本次研讨会之前,请确保您已经:
所需软件
- 码头工人 (v20.10+)-
- 亲切的 (v0.20+)- 安装类型
- 舵 (v3.12+)- 安装Helm
- kubectl 的 (v1.27+)- 安装kubectl
- 紫外线 (最新)- 安装uv
- Node.js (v18+)-
知识先决条件
- 对Kubernetes概念(Pod、部署、服务)的基本理解
- 熟悉Python或Go编程
- Docker基础知识
- 了解REST API和HTTP协议
系统要求
- macOS、Linux或Windows与WSL2
- 8GB+RAM可用
- 20GB+可用磁盘空间
🗺️ 厂房结构
研讨会分为五个实践模块:
模块1:KMCP设置
- 安装KMCP命令行界面
- 使用Kind设置本地Kubernetes集群
- 安装KMCP控制器
- 验证您的环境
持续时间: 20分钟
模块2:您的第一台MCP服务器
- 初始化FastMCP Python项目
- 了解项目结构
- 在本地运行MCP服务器
- 测试内置回声工具
持续时间: 30分钟
模块3:构建自定义工具
- 创建天气API MCP工具
- 实现计算器工具
- 处理工具参数和验证
- 测试您的自定义工具
持续时间: 45分钟
模块4:管理秘密
- 配置特定于环境的机密
- 创建Kubernetes机密
- 带有秘密的Bootstrap MCP服务器
- 秘密管理的最佳实践
持续时间: 30分钟
模块5:部署到Kubernetes
- 构建MCP服务器Docker镜像
- 部署到Kubernetes集群
- 暴露您的MCP服务器
- 监控部署并排除故障
持续时间: 45分钟
🚀 快速开始
1.验证先决条件
运行验证脚本以检查是否安装了所有必需的工具:
./scripts/verify-prerequisites.sh2.安装KMCP命令行界面
curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
kmcp --help3.安装MCP检查器
npm install -g @modelcontextprotocol/inspector4.从模块1开始
导航到第一个模块并开始您的学习之旅:
cd modules
cat 01-setup.md📂 存储库结构
kmcp-workshop/
├── README.md # This file
├── modules/ # Workshop modules
│ ├── 01-setup.md
│ ├── 02-first-server.md
│ ├── 03-custom-tools.md
│ ├── 04-secrets.md
│ └── 05-deploy.md
├── examples/ # Complete example projects
│ ├── weather-mcp/ # Weather API MCP server
│ ├── calculator-mcp/ # Calculator MCP server
│ └── database-mcp/ # Database query MCP server
├── scripts/ # Helper scripts
│ ├── verify-prerequisites.sh
│ ├── setup-cluster.sh
│ └── cleanup.sh
└── resources/ # Additional resources
├── architecture.md
├── troubleshooting.md
└── best-practices.md🎯 研讨会目标
完成本次研讨会后,您将能够:
- ✅ 建立完整的KMCP开发环境
- ✅ 创建生产就绪的MCP服务器
- ✅ 将MCP服务器部署到Kubernetes集群
- ✅ 安全地管理机密和配置
- ✅ 有效测试和调试MCP工具
- ✅ 将MCP服务器与AI代理集成
📖 其他资源
- KMCP文件: https://kagent.dev/docs/kmcp/
- MCP规范: https://spec.modelcontextprotocol.io/
- Kagent GitHub:
- 不和谐社区: https://discord.gg/Fu3k65f2k3
🤝 贡献
发现问题或想改进研讨会?欢迎投稿!
📄 许可证
这个研讨会是开源的,可以在MIT许可证下使用。
🙏 致谢
本次研讨会基于 kagent项目,在Solo.io创建的CNCF沙盒项目。
______________________________________________________________________
准备好开始了吗? 前往 模块1:KMCP设置 开始你的旅程! 🚀
