docker-mcp-sdk

# Docker MCP Server A Model Context Protocol (MCP) server that enables LLMs to safely execute code in isolated Docker containers with strict resource limits and security controls. ## Features - 🔒 **Secure Isolation**: Containers run with strict resource limits (memory, CPU, PIDs) - 🏷️ **Session Management**: Group containers by session with persistent workspaces - ♻️ **Container Reuse**: Optimize performance by reusing existing containers - 📦 **Smart Dependencies**: Auto-detect and install packages (pip, npm, apt, apk) - 🔄 **Streaming Output**: Real-time output for long-running processes - 💾 **Persistent Workspaces**: Session-based volumes maintain state across executions ## Installation ```bash # Clone the repository git clone https://github.com/cevatkerim/docker-mcp.git cd docker-mcp # Install in development mode pip install -e . # Install development dependencies pip install -r requirements-dev.txt ``` ## Prerequisites - Python 3.10+ - Docker Engine running locally - MCP-compatible client (e.g., Claude Desktop) ## Quick Start ### 1. Start the MCP Server ```bash python -m docker_mcp ``` ### 2. Configure Your MCP Client Add to your MCP client configuration: ```json { "mcpServers": { "docker": { "command": "python", "args": ["-m", "docker_mcp"] } } } ``` ## Available Tools ### 1. check_engine Check Docker engine availability and version. ```python result = check_engine() # Returns: Docker version and status ``` ### 2. list_containers List Docker containers with optional filtering. ```python result = list_containers( show_all=True, # Show all containers, not just running session_id="my-session" # Filter by session ) ``` ### 3. create_container Create and start a new container with resource limits. ```python result = create_container( image="python:3.11-slim", name="my-container", session_id="my-session", network_enabled=False, # Network isolation by default reuse_existing=True, # Re…