dm-nkp-gitops-custom-mcp-server

A collection of MCP (Model Context Protocol) and A2A (Agent-to-Agent) servers for monitoring and debugging NKP GitOps infrastructure managed by Flux CD.

Projects in This Repository

This repository contains multiple independent projects, each with its own purpose and implementation:

Project	Description	Language	Status
MCP Server	Primary MCP server for AI assistants (Cursor, Claude Desktop)	Go	✅ Production
A2A Server	Agent-to-Agent server for multi-agent coordination	Go	✅ Production
kmcp-server	Kubernetes-native MCP server using kmcp/Kagent	Python	🔄 Alternative
Multi-Agent Examples	Demo code for A2A multi-agent workflows	Go	📚 Examples
Troubleshooting Examples	Working code examples for runbook patterns	Go	📚 Examples

📖 Start Here: See Deployment and Usage Guide for complete setup instructions.

---

Quick Start: MCP Server (Primary)

The MCP server is the main project for integrating with AI assistants.

Build

make build

Run

# 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

Configure in Cursor

Add to ~/.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"
      }
    }
  }
}

Restart Cursor after saving.

Available Tools

Category	Tool	Description
Context	list_contexts	List available Kubernetes contexts
	get_current_context	Get current active context
GitOps	get_gitops_status	Overall GitOps health summary
	list_kustomizations	List Flux Kustomizations with status
	get_kustomization	Get detailed Kustomization info
	list_gitrepositories	List GitRepository sources
Clusters	get_cluster_status	CAPI cluster status
	list_machines	List CAPI machines
Apps	get_app_deployments	Kommander app deployment status
	get_helmreleases	List HelmReleases
Debug	debug_reconciliation	Debug failing reconciliation
	get_events	Get Kubernetes events
	get_pod_logs	Get pod logs
Policy	check_policy_violations	Check policy violations
	list_constraints	List Gatekeeper constraints

📖 Full Tools Reference → - Complete documentation with parameters, examples, and use cases

Example Queries

Once configured, ask your AI assistant:

"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"

Project Details

1. MCP Server (Primary)

Location: cmd/server/
Binary: dm-nkp-gitops-mcp-server
Purpose: MCP server for AI assistants (Cursor, Claude Desktop, VS Code)

• Uses JSON-RPC 2.0 over stdio
• Exposes 15+ tools for GitOps monitoring
• Read-only mode recommended for production
• See AGENTS.md for AI agent integration guide

Quick Start: make build && ./bin/dm-nkp-gitops-mcp-server serve --read-only

---

2. A2A Server

Location: cmd/a2a-server/
Binary: dm-nkp-gitops-a2a-server
Purpose: Agent-to-Agent server for multi-agent coordination

• HTTP-based server (port 8080)
• Task-based execution (stateful)
• Agent Card discovery at `/.well-known/agent.js

... View full README on GitHub