Kmcp Workshop

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框架
• 秘密管理 用于安全的环境变量处理

🎓 学习目标

在本次研讨会结束时，您将：

1. 了解MCP（模型上下文协议）架构
2. 在本地创建并运行MCP服务器
3. 构建扩展AI代理功能的自定义工具
4. 将MCP服务器部署到Kubernetes集群
5. 管理生产环境中的机密和配置
6. 使用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.sh

2.安装KMCP命令行界面

curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
kmcp --help

3.安装MCP检查器

npm install -g @modelcontextprotocol/inspector

4.从模块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设置 开始你的旅程！ 🚀