komodo-mcp

MCP (Model Context Protocol) server for Komodo, a container and infrastructure management platform. Exposes Komodo's full API as MCP tools, enabling Claude Code and other MCP clients to manage deployments, stacks, servers, builds, and more.

Setup

1. Install dependencies and build

cd komodo-mcp
npm install
npm run build

2. Configure environment variables

The server requires three environment variables:

Generate an API key pair in Komodo under Settings > API Keys.

3. Register with Claude Code

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json or project-level):

{
  "mcpServers": {
    "komodo": {
      "command": "node",
      "args": ["/path/to/komodo-mcp/dist/index.js"],
      "env": {
        "KOMODO_URL": "https://komodo.example.com",
        "KOMODO_API_KEY": "your-api-key",
        "KOMODO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Tool Reference

Tools are grouped by resource domain with an action parameter to keep the tool count manageable (~45 tools instead of 250+).

Read Tools (Query & Inspection)

Write Tools (Create, Update, Delete)

Execute Tools (Lifecycle & Operations)

Usage Examples

# Ask Claude to list your deployments
"List all my Komodo deployments"

# Check server health
"Show me the CPU and memory stats for server prod-1"

# View stack logs
"Get the last 50 lines of logs for the monitoring stack"

# Deploy a stack
"Deploy the web-app stack"

Development

npm run dev    # Watch mode (recompile on changes)
npm run build  # One-time build
npm start      # Run the MCP server