EKS Model Context Protocol (MCP) Server

基本能力

产品定位

EKS Model Context Protocol (MCP) Server 是一个专为 EKS 集群操作设计的轻量级服务器，提供标准化的接口，使 GenAI 代理能够高效地与 EKS 集群进行交互。

核心功能

• 快速响应时间：具备适当的超时处理机制。
• 全面的 EKS 操作支持：包括集群、节点组等操作。
• Kubernetes 资源管理：支持 Pods、Services、Deployments 等资源的管理。
• 多种认证方法：支持 AWS SDK、Kubectl 和直接 Kubernetes API 调用等多种认证方式。
• 健壮的错误处理和日志记录：提供详细的错误代码和日志记录。
• Docker 容器化：便于部署和管理。
• ECS 部署支持：支持在 ECS 上部署。

适用场景

• EKS 集群管理：自动化管理 EKS 集群及其资源。
• Kubernetes 资源监控：实时监控和管理 Kubernetes 资源。
• 开发与测试：为开发和测试环境提供标准化的接口。
• 自动化运维：通过 GenAI 代理实现自动化运维。

工具列表

• Docker：用于容器化部署。
• AWS SDK：用于 AWS 资源管理和认证。
• Kubectl：用于 Kubernetes 资源管理。
• FastAPI：用于构建高效的 API 服务。

常见问题解答

• 认证问题：确保 ECS 任务角色已添加到 EKS 集群的 aws-auth ConfigMap 中。
• 部署问题：参考 ECS Deployment README 获取详细的部署指令。
• API 调用问题：检查 API 密钥和参数是否正确。

使用教程

使用依赖

• Docker：用于容器化部署。
• AWS 凭证：用于生产环境。
• Python 3.8+：用于本地开发。

安装教程

本地运行

# 安装依赖
pip install -r requirements.txt

# 运行服务器
python main.py

使用 Docker 运行

# 构建 Docker 镜像
docker build -t eks-mcp-server .

# 运行容器
docker run -d -p 8000:8000 --name mcp-server eks-mcp-server

使用 Docker Compose 运行

# 启动服务器
docker-compose up -d

# 停止服务器
docker-compose down

部署到 ECS

# 部署到 ECS
cd ecs-deployment
./deploy.sh

# 更新现有 ECS 部署
./update-service.sh

调试方式

# 基本测试
python test_mcp.py

# 全面操作测试
python test_mcp_operations.py

# 测试命名空间集成
python test_mcp_namespace.py
python test_mcp_namespace_2.py

# 测试 kubectl 集成
python test_kubectl_operations.py

# 测试 SDK v3 操作
python test_v3_operations.py

# 测试 SDK v4 操作
python test_v4_operations.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。