- Komodo MCP Server
Komodo MCP Server
🦎 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
🐳 Container Management
|
📦 Deployment & Stacks
|
🖥️ Server Operations
|
🤖 MCP Integration
|
⚡ Performance
|
🔒 Security & Reliability
|
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 (API Key/Secret or 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
Observability (OpenTelemetry)
Enable distributed tracing and metrics with OpenTelemetry:
| Variable | Default | Description |
|---|---|---|
OTEL_ENABLED | false | Enable OpenTelemetry |
OTEL_SERVICE_NAME | mcp-server | Service name for traces |
OTEL_EXPORTER_OTLP_ENDPOINT | - | OTLP endpoint (e.g., Jaeger, Grafana) |
OTEL_DEBUG | false | Enable debug logging |
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
Recommend Servers
View All高德地图官方 MCP Server
A Serper MCP Server
test