Komodo MCP Server

Created By
MP-Tool4 months ago
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.
Overview

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

License: GPL-3.0 GitHub Release Docker MCP

Build Status CodeQL OpenSSF Scorecard GitHub Issues

FeaturesQuick StartExamplesDocumentation


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 for logging
  • 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

# 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

Observability (OpenTelemetry)

Enable distributed tracing and metrics with OpenTelemetry:

VariableDefaultDescription
OTEL_ENABLEDfalseEnable OpenTelemetry
OTEL_SERVICE_NAMEmcp-serverService name for traces
OTEL_EXPORTER_OTLP_ENDPOINT-OTLP endpoint (e.g., Jaeger, Grafana)
OTEL_DEBUGfalseEnable 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)

Built with ❤️ for the Komodo community 🦎 Report BugRequest FeatureDiscussions

Project Info
Created At
4 months ago
Updated At
4 months ago
Author Name
MP-Tool
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All
Bring your real authenticated browser session to AI coding agents. Local-first MCP server + Chrome MV3 extension. No cloud. No telemetry.
@Cubenest

peek records the user's actual logged-in browser (DOM via rrweb, console events, network metadata, optional response bodies via opt-in Deep capture) through a Chrome MV3 extension. The extension ships events through a native-messaging stdio bridge to a local MCP server (peek-mcp), which persists them to a SQLite database at ~/.peek/sessions.db. AI coding agents (Claude Code, Cursor, Cline, Windsurf) read sessions from the database via 10 MCP tools: Tool What it does list_recent_sessions List recently recorded sessions (id, origin, ts, event count). get_session_summary LLM-readable narrative summary of a session. get_session_console_errors Console errors recorded in a session. get_session_network_errors Failed/notable network requests in a session. get_user_action_before_error Last N user actions before a console error. generate_playwright_repro Generate a runnable Playwright test from a session. get_dom_snapshot Reconstruct the DOM at a given timestamp. query_dom_history Timeline of attribute/text changes for a selector. request_authorization Side-panel consent for write actions (Level 3). execute_action Dispatch a UI action (gated by permission level + destructive blocklist). Why local-first matters Every other "browser session for AI" tool ships to a vendor cloud. peek's SQLite + extension live on the user's machine — no remote endpoints, no telemetry. The privacy policy (docs/peek/PRIVACY_POLICY.md) is the source of truth. Install # 1. Add the MCP server to Claude Code claude mcp add peek -- npx -y @peekdev/mcp # 2. Install the Chrome extension from the Chrome Web Store # (link added once the CWS listing is approved)

a day ago