komodo-mcp-server

MP-Tool/komodo-mcp-server

3.3

If you are the rightful owner of komodo-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Komodo MCP Server is a Model Context Protocol server designed for managing Docker containers, deployments, and stacks through AI assistants and automation tools.

Tools
14
Resources
0
Prompts
0

🦎 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.

GitHub Release Docker MCP

Build Status CodeQL OpenSSF Scorecard GitHub Issues

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)

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 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

  • - Direct MCP integration
  • - GitHub Copilot Chat support
  • - Standalone deployment
  • - Native MCP beta feature

License

GPL-3.0 License - see for details.

Contributing

Contributions are welcome! See our 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 ).

Best practices:

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

Links

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