CLP MCP - DevOps Infrastructure Server

# CLP MCP - DevOps Infrastructure Server A comprehensive Model Context Protocol (MCP) server designed for DevOps and infrastructure management. This server provides extensive tooling for Jenkins, Ansible, Terraform, Kubernetes, and Docker, along with a sophisticated memory system for context retention and reasoning tracking. ## Features ### 🧠 Memory System - **Store & Recall**: Persistent key-value storage with metadata - **Search**: Full-text search across stored data with category filtering - **Reasoning Tracking**: Record and retrieve decision-making context - **Context Management**: Maintain state across interactions ### 🔧 DevOps Tools #### Jenkins - Validate Jenkinsfiles for syntax and security issues - Generate pipeline templates for multiple project types - Analyze pipelines for optimization opportunities #### Ansible - Validate playbooks for best practices - Generate playbook templates (webserver, database, K8s, etc.) - Lint playbooks for anti-patterns - Generate inventory files (INI/YAML) #### Terraform - Validate configurations and detect security issues - Generate module templates (VPC, EC2, RDS, S3, etc.) - Format code to canonical style - Analyze state files - Generate backend configurations #### Kubernetes - Validate manifests against best practices - Generate resource templates (Deployments, Services, etc.) - Create Helm charts - Analyze resources for optimization - Generate Kustomization files #### Docker - Validate Dockerfiles for security and optimization - Generate multi-stage Dockerfile templates - Create docker-compose.yml files - Optimize existing Dockerfiles - Analyze image structures ### 📚 Resources - DevOps best practices documentation - Jenkins pipeline examples - Terraform module patterns ### 💡 Prompts - Infrastructure audit checklists - Deployment strategy recommendations ## Installation ```bash bun install ``` ## Development Run the development server with hot reload: ```bash bun run dev ``` ## Build Build for production: ```bash bun run build ``` ## Usage This MCP server can be used with any MCP-compatible client (Claude Desktop, etc.). See [DEVOPS_TOOLS.md](./DEVOPS_TOOLS.md) for comprehensive documentation of all tools and usage examples. ### Quick Examples **Store Infrastructure Info:** ```json { "tool": "memory_store", "arguments": { "key": "prod_vpc_id", "value": "vpc-12345", "tags": ["production", "networking"], "category": "terraform" } } ``` **Generate Jenkins Pipeline:** ```json { "tool": "generate_jenkinsfile", "arguments": { "projectType": "nodejs", "stages": ["build", "test", "deploy"], "agent": "docker" } } ``` **Validate Kubernetes Manifest:** ```json { "tool": "validate_k8s_manifest", "arguments": { "content": "apiVersion: apps/v1\nkind: Deployment\n..." } } ``` ## Documentation - **[DEVOPS_TOOLS.md](./DEVOPS_TOOLS.md)**: Complete tool reference and usage examples - **[AGENTS.md](./AGENTS.md)**: Development and deployment guide ## Architecture Built on: - **@modelcontextprotocol/sdk**: Official MCP TypeScript SDK - **@smithery/sdk**: Smithery platform integration - **Zod**: Schema validation - **Bun**: Fast JavaScript runtime ## Memory System Architecture The memory system provides: 1. **Key-Value Storage**: Store any JSON-serializable data with metadata 2. **Tagging**: Organize data with multiple tags 3. **Categories**: Group data by infrastructure type 4. **Search**: Full-text search across keys, values, and tags 5. **Reasoning History**: Track decision-making context and rationale 6. **Context Management**: Session-specific context storage ## Tool Categories ### Memory (6 tools) - memory_store, memory_recall, memory_delete - memory_search, add_reasoning, get_reasoning_history ### Jenkins (3 tools) - validate_jenkinsfile, generate_jenkinsfile, analyze_jenkins_pipeline ### Ansible (4 tools) - validate_ansible_playbook, generate_ansible_playbook - lint_ansible_playbook, generate_ansible_inventory ### Terraform (5 tools) - validate_terraform, generate_terraform_module, format_terraform - analyze_terraform_state, generate_terraform_backend ### Kubernetes (5 tools) - validate_k8s_manifest, generate_k8s_manifest, generate_helm_chart - analyze_k8s_resources, generate_kustomization ### Docker (5 tools) - validate_dockerfile, generate_dockerfile, generate_docker_compose - optimize_dockerfile, analyze_docker_image **Total: 28 tools** for comprehensive DevOps infrastructure management ## Contributing Contributions are welcome! Please ensure all tools follow the established patterns and include comprehensive error handling. ## License ISC ## Project Info This project uses [Bun](https://bun.com), a fast all-in-one JavaScript runtime.