MCP Kubernetes

🚀 Kubernetes MCP Server

An experimental Model Context Protocol (MCP) server that exposes Kubernetes capabilities to AI chat interfaces via kubectl. This project demonstrates how to integrate Kubernetes into an AI assistant, enabling it to analyze and manage your cluster resources using familiar kubectl commands.

🚀 Quick Start

The Kubernetes MCP Server is an innovative project that bridges the gap between AI chat interfaces and Kubernetes clusters. It empowers AI assistants to interact with your Kubernetes resources using the well - known kubectl commands.

✨ Features

• Resource Discovery: Enable your AI assistant to list and describe resources using kubectl commands.
• Troubleshooting: Let the AI assist in analyzing logs and resource states.
• Resource Management: Get AI help to create or modify resources.
• Documentation: Ask the AI to explain specific resources in the cluster.
• Security Analysis: Have the AI identify potential security issues in the configuration.

💻 Usage Examples

Basic Usage

User: Can you show all pods in the default namespace?
AI: Let me check for you...
[Execute the command "get pods -n default" using the kubectl tool]
Here are the pods in the default namespace:
NAME                     READY   STATUS    RESTARTS   AGE
nginx-7c658794b9-2j4k5   1/1     Running   0          2d

📚 Documentation

Future Possibilities

The current implementation lays the foundation for many powerful interactions:

• Complex troubleshooting scenarios using multiple kubectl commands.
• Automated resource analysis and recommendations.
• Interactive debugging sessions.
• Security scans and recommendations.
• Performance optimization suggestions.

📦 Installation

1. Clone the repository:

git clone https://github.com/yourusername/mcp-kubernetes.git
cd mcp-kubernetes

2. Build the project:

cargo build --release

3. Configure your AI assistant to use the server (specific steps depend on your AI platform).

Requirements

• Rust 1.70 or higher.
• kubectl installed and configured.
• A Kubernetes cluster with appropriate permissions.
• kubeconfig configured for your cluster.

Configuration

The server uses the default kubeconfig and kubectl installation. Ensure you have the appropriate permissions to execute the required commands.

🔧 Technical Details

Security Considerations

Since this server allows the execution of arbitrary kubectl commands, the following points need attention:

1. Run with appropriate RBAC permissions.
2. Consider implementing command validation or a whitelist.
3. Monitor and audit command execution.
4. Use in a controlled environment.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This project is based on the mcpr project (created by @conikeec). Thanks to the author for creating this excellent protocol and implementation.