Dm Nkp Gitops Custom MCP Server

dm-nkp-gitops定制mcp服务器

一组MCP（模型上下文协议）和A2A（代理到代理）服务器，用于监控和调试由Flux CD管理的NKP GitOps基础设施。

此存储库中的项目

此存储库包含多个独立的项目，每个项目都有自己的目的和实现：

📖 从这里开始：参见 部署和使用指南 有关完整的设置说明。

______________________________________________________________________

快速入门：MCP服务器（主）

MCP服务器是与AI助手集成的主要项目。

构建

make build

跑

# With default kubeconfig
./bin/dm-nkp-gitops-mcp-server serve

# With specific kubeconfig in read-only mode
KUBECONFIG=/path/to/kubeconfig ./bin/dm-nkp-gitops-mcp-server serve --read-only

在游标中配置

增添 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dm-nkp-gitops": {
      "command": "/path/to/dm-nkp-gitops-mcp-server",
      "args": ["serve", "--read-only"],
      "env": {
        "KUBECONFIG": "/Users/deepak.muley/ws/nkp/dm-nkp-mgmt-1.conf"
      }
    }
  }
}

保存后重新启动Cursor。

可用工具

📖 完整工具参考→ -包含参数、示例和用例的完整文档

查询示例

配置后，询问您的AI助手：

"What's the GitOps status of my cluster?"

"Why is the clusterops-clusters Kustomization failing?"

"Show me all CAPI clusters and their health"

"Check for any policy violations"

"Debug the reconciliation failure for clusterops-workspace-applications"

项目详情

1.MCP服务器（主）

位置: cmd/server/\ 二进制: dm-nkp-gitops-mcp-server\ 目的：用于AI助手的MCP服务器（Cursor、Claude Desktop、VS Code）

• 通过stdio使用JSON-RPC 2.0
• 公开了15多种GitOps监控工具
• 建议用于生产的只读模式
• 看 代理商.md AI代理集成指南

快速开始: make build && ./bin/dm-nkp-gitops-mcp-server serve --read-only

______________________________________________________________________

2.A2A服务器

位置: cmd/a2a-server/\ 二进制: dm-nkp-gitops-a2a-server\ 目的：用于多代理协调的代理到代理服务器

• 基于HTTP的服务器（端口8080）
• 基于任务的执行（有状态）
• 在以下位置发现代理卡 /.well-known/agent.json
• 通过以下方式与MCP服务器共享工具实现 pkg/tools/

快速开始: make build-a2a && ./bin/dm-nkp-gitops-a2a-server serve

文档:

• A2A学习指南 -A2A教程
• A2A协议 -协议解释和MCP比较
• 多代理示例 -编排多个代理的演示代码

______________________________________________________________________

3.kmcp服务器（Kubernetes原生）

位置: kmcp-server/\ 语言python\ 目的：使用kmcp/Kagent框架的替代实现

• 通过MCPServer CRD进行Kubernetes本地部署
• 自动管理RBAC和扩展
• 使用FastMCP SDK
• 具有相同工具名称的并行实现

快速开始：参见 kmcp服务器/README.md

文档:

• kmcp服务器自述文件 -完整的设置和部署指南
• KMCP学习指南 -kmcp框架的学习路径
• 框架比较 -自定义vs kmcp vs其他框架

______________________________________________________________________

4.示例

多代理示例

位置: examples/multi-agent/\ 目的：显示A2A多代理协调的演示代码

• 用于协调专业代理的编排器模式
• 示例工作流（GitOps健康检查、事件调查）
• 看 examples/multi-agent/README.md 详情

快速开始: make demo-multi-agent （需要A2A服务器运行）

故障排除示例

位置: examples/troubleshooting/\ 目的：程序化Runbook的工作代码示例

• 结构化工作流定义
• 决策树模式
• 工具调用生成示例
• 看 示例/故障排除/README.md 详情

快速开始: make build-troubleshooter && ./bin/troubleshooter gitops-failure

______________________________________________________________________

文档

入门指南

• 部署和使用指南 - 🚀 从这里开始 -关于部署、配置和实际使用的完整指南
• 工具参考 - 📖 所有15个工具的完整文档，包括参数和示例
• 代理商.md -此存储库的AI代理集成指南

协议指南

• MCP底漆 -了解MCP协议
• A2A学习指南 -A2A教程
• A2A协议 -Agent到Agent协议的解释及其与MCP的比较
• KMCP学习指南 -kmcp框架的学习路径
• 框架比较 -自定义vs kmcp vs其他框架

运行手册和最佳实践

• K8S故障排除操作手册 - 📋 包含工作流程和示例的全面故障排除指南
• K8S安全运行手册 - 🔒 Kubernetes集群的安全评估和强化指南
• Runbook最佳实践 - 📚 创建AI代理友好运行手册的标准做法（模板参考）
• 故障排除示例 -runbook模式的工作代码示例
• 测试指导 - 📚 如何构建、测试和学习故障排除示例

架构和高级主题

• MCP服务器架构 -深入了解服务器流程和推荐功能
• 安全 -安全分析和加固指南
• 企业部署 -生产部署指南
• NKP生产部署 - 🚀 Nutanix Kubernetes平台完整指南
• 通量MCP设置 -使用官方Flux MCP服务器

发展

构建所有项目

# Build MCP server
make build

# Build A2A server
make build-a2a

# Build both servers
make build-both

# Build troubleshooting examples
make build-troubleshooter

运行测试

# Run Go unit tests
make test

# Test MCP protocol
make test-mcp

# Test A2A server
make test-a2a-card
make test-a2a-health

# Test troubleshooting workflows
make test-troubleshooter

代码质量

# Format code
make fmt

# Lint
make lint

看 make help 对于所有可用的目标。

使用Kind集群进行测试

使用一个集群和Flux CD在本地测试MCP服务器：

# Prerequisites: kind, kubectl, flux CLI, jq

# Full setup and test (creates cluster, installs Flux, runs tests)
make kind-all

# Or step by step:
make kind-setup      # Create kind cluster with Flux CD
make kind-test       # Run MCP tests
make kind-interactive # Interactive testing mode
make kind-cleanup    # Delete cluster

# Manual testing
./scripts/test-with-kind.sh all

测试脚本将：

1. 创建一个名为 mcp-test
2. 安装Flux CD控制器
3. 部署示例GitOps资源（Kustomization、GitRepositories、HelmRelease）
4. 运行一套MCP协议测试
5. Cursor集成的打印配置

安全

始终使用 --read-only 生产模式 以防止意外的突变。

看 安全文档 用于：

• 安全分析和威胁模型
• 限制访问的RBAC配置
• 硬化建议

建筑

┌─────────────────┐     stdin/stdout      ┌─────────────────────┐
│  AI Assistant   │◄────────────────────►│  MCP Server         │
│  (Cursor/Claude)│     JSON-RPC 2.0      │                     │
└─────────────────┘                       │  ┌───────────────┐  │
                                          │  │ Tool Handlers │  │
                                          │  └───────┬───────┘  │
                                          │          │          │
                                          │          ▼          │
                                          │  ┌───────────────┐  │
                                          │  │ K8s Clients   │  │
                                          │  └───────┬───────┘  │
                                          └──────────┼──────────┘
                                                     │
                                                     ▼
                                          ┌─────────────────────┐
                                          │  Kubernetes API     │
                                          │  - Flux CRDs        │
                                          │  - CAPI CRDs        │
                                          │  - Kommander CRDs   │
                                          │  - Core resources   │
                                          └─────────────────────┘

独立工程

此存储库中的每个项目都旨在 独立 为了可维护性：

• MCP 服务器 和 A2A服务器 分享 pkg/tools/ 但可以单独构建/部署
• kmcp服务器 完全独立（Python，独立依赖项）
• 例子 是独立的演示/学习代码
• 每个项目都有自己的README，其中包含具体的说明

这种结构允许：

• 独立的版本控制和发布
• 单独的维护周期
• 如果需要，可以轻松提取到单独的存储库
• 关注点清晰分离

相关项目

• dm-nkp-gitops基础设施 -GitOps基础架构仓库
• 通量操作员MCP -官方Flux MCP服务器
• 卡金特 -Kubernetes的CNCF AI代理框架

许可证

麻省理工学院