MCP Server Dynamic Env

🚀 Dynamic Environment MCP Server

A high-performance Kubernetes MCP server for managing DynamicEnv custom resources, supporting real-time updates and AI-driven integration.

🚀 Quick Start

Clone the repository

git clone https://github.com/yonathan-shtekel/mcp-server-dynamic-env.git
cd mcp-server-dynamic-env

Create a virtual environment

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

Install dependencies

uv pip install -e .

✨ Features

Overview

The Dynamic Environment MCP Server provides an AI-friendly API interface on the DynamicEnv Kubernetes custom resource, enabling real-time tracking, intelligent debugging, and simplified cleanup operations for dynamic environments. It is suitable for development, testing, and short-term workloads.

The server is designed with an asynchronous-first architecture and seamlessly integrates with the Model Context Protocol (MCP), empowering developers and AI agents to manage K8s-based environments securely and efficiently.

What is DynamicEnv?

DynamicEnv is a Kubernetes custom resource (CRD) that encapsulates a complete dynamic environment configuration, typically including:

• Multiple interdependent services
• Service-specific configurations (secrets, configuration files, environment variables)
• Routing rules (Ingress, service mesh)
• Resource limits (CPU, memory quotas)

This server enhances the observability and control of these resources.

Why Choose MCP?

The Model Context Protocol (MCP) allows AI tools to:

• Subscribe to real-time updates
• Manage long-term asynchronous operations and track progress
• Run securely through verified and structured contexts
• Improve intelligent command suggestions in DevOps workflows

Core Functions

• ✅ List and Filter: Filter DynamicEnv instances by namespace, status, or deployment status.
• ⏳ Real-time Status Monitoring: Asynchronous updates and progress reports.
• ❌ Safe Deletion: Environment cleanup with dependency checks.
• ⚖️ K8s Security Authentication: Use in-cluster or kubeconfig credentials.
• 🔍 Pod Insights, deployment health, and optional logs.
• ✨ AI-friendly interface through MCP.

💻 Usage Examples

Local Development

# Install MCP tools
mcp tool install

# Start the MCP service
mcp server start

Example Commands

# Create a DynamicEnv instance
mcp dynamicenv create --name my-env --spec '{"containers": [{"name": "web", "image": "nginx:latest"}]}'

# Get the instance status
mcp dynamicenv get my-env

📚 Documentation

Project Structure

.
├── README.md          # Project documentation
├── pyproject.toml    # Project configuration
├── src/
│   ├── server.py     # Main program of the MCP server
│   └── handlers/
│       └── dynamicenv.py  # Processing logic for DynamicEnv resources
└── tests/
    └── test_server.py  # Test cases for server functions

Development Specifications

# Type checking
mypy src tests

# Security scanning
bandit -r src
safety check

# Documentation coverage
interrogate src

All these checks will be automatically executed in the CI/CD pipeline.

Other Tools

• Logging: Use the logging module to implement structured logging.
• Configuration Management: Manage project settings uniformly through pyproject.toml.
• Testing Framework: A unit testing framework based on pytest.

📄 License

Contributions are welcome! For help, please refer to CONTRIBUTING.md.