🦎 Komodo MCP Server

Model Context Protocol Server for Komodo

Manage your Docker or Podman deployments through Komodo with AI assistants and automation tools.

Komodo MCP Server enables seamless interaction between AI assistants (like Claude, GitHub Copilot) and Komodo (Container Management Platform) for efficient container management, server orchestration, and deployment operations. The MCP-Server gives you the ability to control your Komodo-managed infrastructure by using natural language or automated workflows.

Features • Quick Start • Examples • Documentation

---

Features

🐳 Container Management Start, stop, restart containers Pause and unpause operations List and monitor containers Cross-server management	📦 Deployment & Stacks Deploy containers and updates Manage Docker Compose stacks Multi-environment deployments Stack lifecycle control
🖥️ Server Operations List all managed servers Get server statistics Health monitoring Resource tracking	🤖 MCP Integration Works with any MCP client Claude Desktop ready VS Code Copilot support n8n automation compatible

Quick Start

Option 1: Docker (Recommended)

# Pull the image
docker pull ghcr.io/mp-tool/komodo-mcp-server:latest

# Run with Docker Compose
cd examples/compose
cp .env.example .env
# Edit .env with your Komodo credentials
docker compose up -d

Option 2: Claude Desktop

# Copy config
cp examples/claude/claude_desktop_config.json \
   ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Edit credentials and restart Claude

Option 3: VS Code

# Global integration
mkdir -p ~/.vscode/mcp
cp examples/vscode/mcp.json ~/.vscode/mcp/

# Edit credentials and reload VS Code

📚 Full setup guides: See examples/ for detailed instructions

Examples

💬 With AI Assistants

Ask Claude, Copilot, or any MCP-compatible assistant:

"List all my Komodo servers"
"Show containers on production-server"  
"Start the nginx container"
"Deploy my-app to staging"
"Get stats for dev-server"

🔄 With n8n Automation

Comming soon: Pre-built n8n workflows for automated container health checks and deployment pipelines.

Documentation

Requirements

• Komodo v1.19.5 or later
• Docker (for containerized deployment)
• Node.js 20+ (for local development)
• Valid Komodo credentials (username/password)

Integration Guides

• Claude Desktop - Direct MCP integration
• VS Code - GitHub Copilot Chat support
• Docker Compose - Standalone deployment
• Docker Desktop - Native MCP beta feature

License

GPL-3.0 License - see LICENSE for details.

Contributing

Contributions are welcome! See our Contributing Guide for details.

• 🐛 Report bugs
• 💡 Request features
• 🔧 Submit PRs

Development

# Clone and install
git clone https://github.com/MP-Tool/komodo-mcp-server.git
cd komodo-mcp-server
npm install

# Build and run
npm run build
npm start

Security

Report security vulnerabilities via GitHub's Private Vulnerability Reporting (see SECURITY.md).

Best practices:

• Never commit credentials
• Use environment variables
• Keep dependencies updated
• Run as non-root user (default in Docker)

Links

• Komodo GitHub - Container orchestration platform
• Komodo Docs - Komodo documentation
• Model Context Protocol - MCP specification
• Examples & Integrations - Ready-to-use configurations

---

Built with ❤️ for the Komodo community 🦎 Report Bug • Request Feature • Discussions