🦎 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
Dual Transport (Stdio + HTTP/SSE)

⚡ Performance

Pre-compiled regex
Tool registry caching
O(1) circular buffer history
Request cancellation support

🔒 Security & Reliability

DNS rebinding protection
Rate limiting (configurable)
CORS origin validation
Graceful shutdown handling

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

Additional Configuration & Integration Guides

VS Code Copilot Chat

Just copy the provided mcp.json to your VSCode workspace

cp examples/vscode/mcp.json .vscode/

📚 Full setup guides: See examples/ for detailed instructions

Use

Testing with MCP Inspector Tool

Try it out with the MCP Inspector Tool

NOTE: Use http://<IP/DOMAIN>:<PORT>/mcp for Streamable HTTP transport or http://<IP/DOMAIN>:<PORT>/sse for SSE transport (if enabled). If both transports are enabled, the server will prioritize Streamable HTTP but SSE is also available on /mcp endpoint. Correct the ip/domain and port to your configuration.

npx @modelcontextprotocol/inspector --url http://localhost:3000/mcp

💬 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 (API Key/Secret or username/password)

Integration Guides

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

License

GPL-3.0 License - see LICENSE for details.

Contributing

Contributions are welcome! See our Contributing Guide for details.

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

Komodo MCP Server

Quick Install