Kube Core MCP

# Kube Core MCP A Kubernetes command processing service that converts natural language requests into valid kubectl commands. ## Features - Natural language to kubectl command conversion - Command validation and security checks - Support for common kubectl operations - AWS Bedrock integration for LLM processing ## Prerequisites - Python 3.8+ - AWS credentials configured - kubectl installed and configured - Node.js and npm (for frontend) ## Setup 1. Clone the repository: ```bash git clone <repository-url> cd kube-core-mcp ``` 2. Create and activate a virtual environment: ```bash python3 -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate ``` 3. Install dependencies: ```bash pip install -r requirements.txt ``` 4. Configure AWS credentials: ```bash export AWS_ACCESS_KEY_ID=your_access_key export AWS_SECRET_ACCESS_KEY=your_secret_key export AWS_REGION=your_region ``` 5. Start the FastAPI server: ```bash python src/server.py ``` ## API Documentation ### Health Check ```bash curl http://localhost:3000/health ``` ### Services ```bash curl http://localhost:3000/api/services ``` ### Natural Language Commands ```bash curl -X POST http://localhost:3000/api/nl \ -H "Content-Type: application/json" \ -d '{"message": "show me the pods in default namespace"}' ``` ### Direct Commands ```bash curl -X POST http://localhost:3000/api/command \ -H "Content-Type: application/json" \ -d '{"command": "kubectl get pods -n default"}' ``` ## Security The service operates in two security modes: 1. STRICT (default): - Only allows predefined command patterns - Validates all commands against allowed patterns - Prevents dangerous operations 2. PERMISSIVE: - Allows more flexible command patterns - Still maintains basic security checks - Useful for development and testing ## Development ### Running Tests ```bash pytest tests/ ``` ### Code Style ```bash black src/ tests/ flake8 src/ tests/ ``` ### Contributing 1. Fork the repository 2. Create a feature branch 3. Make your changes 4. Run tests 5. Submit a pull request ## License [Add License Information]