Skip to content
MCP server

Komodo MCP Server

MCP server that lets AI assistants manage Komodo DevOps servers, stacks and deployments

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.9.1
Listing updated
today

Similar MCP servers

About Komodo MCP Server

Komodo MCP Server is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

The README describes an MCP server that connects a Komodo Core instance to AI clients such as Cursor, Claude Code and Claude Desktop, so servers, stacks, deployments and builds can be queried or acted on in plain language. It exposes 63 tools grouped into 14 categories that cover the Komodo DevOps API.

Access is controlled by a tier setting: read-only, read-execute, or full. Lower tiers hide deploy, destroy and write tools from the client entirely. Category and tool allowlists or blocklists can narrow the set further. User administration tools need a Komodo admin account regardless of tier.

The server runs over stdio via npx or Docker, or as a Streamable HTTP endpoint. The README warns that the HTTP transport has no authentication, so it should stay on loopback or behind an authenticating proxy. It is aimed at engineers who already run Komodo and want to operate it from an AI assistant.

Install

Run in a terminal

claude mcp add mcp-komodo --env KOMODO_URL='<KOMODO_URL>' --env KOMODO_API_KEY='<KOMODO_API_KEY>' --env KOMODO_API_SECRET='<KOMODO_API_SECRET>' -- npx -y @samik081/mcp-komodo

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-komodo": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-komodo"
      ],
      "env": {
        "KOMODO_URL": "<KOMODO_URL>",
        "KOMODO_API_KEY": "<KOMODO_API_KEY>",
        "KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-komodo": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-komodo"
      ],
      "env": {
        "KOMODO_URL": "<KOMODO_URL>",
        "KOMODO_API_KEY": "<KOMODO_API_KEY>",
        "KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-komodo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-komodo"
      ],
      "env": {
        "KOMODO_URL": "<KOMODO_URL>",
        "KOMODO_API_KEY": "<KOMODO_API_KEY>",
        "KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-komodo": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-komodo"
      ],
      "env": {
        "KOMODO_URL": "<KOMODO_URL>",
        "KOMODO_API_KEY": "<KOMODO_API_KEY>",
        "KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-komodo": {
      "command": "npx",
      "args": [
        "-y",
        "@samik081/mcp-komodo"
      ],
      "env": {
        "KOMODO_URL": "<KOMODO_URL>",
        "KOMODO_API_KEY": "<KOMODO_API_KEY>",
        "KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KOMODO_URLURL of the Komodo instance (e.g. https://komodo.example.com)Required
  • KOMODO_API_KEYKomodo API keyRequired
  • KOMODO_API_SECRETKomodo API secretRequired
  • KOMODO_URLURL of the Komodo instance (e.g. https://komodo.example.com)Required
  • KOMODO_API_KEYKomodo API keyRequired
  • KOMODO_API_SECRETKomodo API secretRequired

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

komodo_list_servers
List all servers with status and region
komodo_get_server_stats
Get CPU, memory, disk usage, and load averages
komodo_list_stacks
List all stacks with state, server, and service count
komodo_get_stack_log
Get logs from stack services, with optional search
komodo_deploy_stack
Deploy or redeploy a stack
komodo_pull_stack
Pull latest images without redeploying (docker compose pull)
komodo_stack_lifecycle
Start, stop, restart, pause, or unpause a stack; optionally targets specific services
komodo_list_updates
List operation history with filters for resource type, target, operation, and success
komodo_get_update
Get full operation details including logs with stdout/stderr for each stage
komodo_trigger_sync
Trigger a GitOps sync from the Git repo

What it does

Broad Komodo API coverage
Provides 63 tools across servers, stacks, deployments, builds, repos, procedures and more.
Tiered access control
Read-only, read-execute and full tiers decide which tools are registered with the client.
Category and tool filtering
Environment variables allow exposing only chosen categories or excluding named tools.
Stdio and HTTP transports
Runs as a local stdio process via npx or Docker, or as a remote HTTP MCP endpoint.
Operation log inspection
Lists operation history and fetches full stdout and stderr for each stage of a failed run.
Secret redaction for env values
Inspect tools replace container environment values with hashes unless explicitly allowed.

Good for

  • Check server CPU, memory and disk usage from a chat assistant
  • Review logs from a failing stack and find the cause of a failed deploy
  • Redeploy or pull new images for a stack without leaving the editor
  • Trigger a GitOps resource sync from a configured Git repository
  • Prune unused Docker resources on a managed server

Pricing

Open source

MIT licensed, free to self-host.

Komodo MCP Server FAQ

Which Komodo version is it built for?

The README says it is built for Komodo 1.19.5.

How is access restricted?

The KOMODO_ACCESS_TIER variable sets read-only, read-execute or full. Tools outside the tier are not registered with the MCP server.

What credentials does it need?

KOMODO_URL, KOMODO_API_KEY and KOMODO_API_SECRET are required. The server validates the connection on startup.

Is the HTTP transport secured?

The README says the HTTP transport has no authentication and recommends keeping it on loopback or behind an authenticating reverse proxy.

Is Komodo MCP Server free?

Yes. Komodo MCP Server is open source, so you can use and self-host it for free.

How do I add Komodo MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-komodo --env KOMODO_URL='<KOMODO_URL>' --env KOMODO_API_KEY='<KOMODO_API_KEY>' --env KOMODO_API_SECRET='<KOMODO_API_SECRET>' -- npx -y @samik081/mcp-komodo

What are the best alternatives to Komodo MCP Server?

The closest alternatives to Komodo MCP Server are Proxmox VE MCP Server, mcp, MCP Server, RunCloud MCP by usefulapi and maintenant.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers