Kube Core MCP

by Jess321995
1
  • Linux

Integrations

  • Exposes API endpoints for health checks, service discovery, natural language command processing, and direct command execution through a REST interface

  • Converts natural language requests into valid kubectl commands for Kubernetes cluster management, supporting operations like viewing pods, services, and other resources across namespaces with built-in security validation

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:
git clone <repository-url> cd kube-core-mcp
  1. Create and activate a virtual environment:
python3 -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure AWS credentials:
export AWS_ACCESS_KEY_ID=your_access_key export AWS_SECRET_ACCESS_KEY=your_secret_key export AWS_REGION=your_region
  1. Start the FastAPI server:
python src/server.py

API Documentation

Health Check

curl http://localhost:3000/health

Services

curl http://localhost:3000/api/services

Natural Language Commands

curl -X POST http://localhost:3000/api/nl \ -H "Content-Type: application/json" \ -d '{"message": "show me the pods in default namespace"}'

Direct Commands

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

pytest tests/

Code Style

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]

-
security - not tested
F
license - not found
-
quality - not tested

A Kubernetes command processing service that converts natural language requests into valid kubectl commands, providing command validation and security checks.

  1. Features
    1. Prerequisites
      1. Setup
        1. API Documentation
          1. Health Check
          2. Services
          3. Natural Language Commands
          4. Direct Commands
        2. Security
          1. Development
            1. Running Tests
            2. Code Style
            3. Contributing
          2. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              TypeScript implementation of Kubernetes cluster operations for pods, deployments, services.
              Last updated -
              9
              1,194
              560
              TypeScript
              MIT License
              • Linux
              • Apple
            • A
              security
              F
              license
              A
              quality
              A MCP server that can run Kubernetes commands with a given kubeconfig path and provide interpretation of the commands.
              Last updated -
              1
              2
              JavaScript
              • Apple
            • -
              security
              A
              license
              -
              quality
              A read-only MCP server for Kubernetes that allows querying cluster information and diagnosing issues through natural language interfaces like Claude.
              Last updated -
              1
              Python
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              An MCP server that enables interaction with Kubernetes/Minikube clusters through natural language, allowing AI agents like Codename Goose to manage Kubernetes resources via the Model Context Protocol.
              Last updated -
              Python
              MIT License

            View all related MCP servers

            ID: zcpd66bfu2