# Komodo MCP Server

An MCP server that hands your assistant the keys to Komodo: containers, stacks, deployments, servers and builds. Useful when infra work happens from the chat window.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 51
- Author: MP-Tool
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MP-Tool/komodo-mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/komodo-mcp-server

## What it does

The server exposes Komodo as a tool set that assistants can call. Containers, stacks, deployments, servers, builds, repos, procedures and actions are all covered, from listing and inspecting to deploying, building and destroying. A remote terminal runs commands on servers, containers and stack services, returning output, exit codes and progress. Log search matches patterns with a configurable tail and a match count.

Transports include stdio, streamable HTTP, HTTPS with TLS and SSE. For auth you pick an API key and secret, a username and password, or a JWT token; in HTTP mode per-user local login is on unless you turn it off. Destructive calls such as deletes, prunes and shell execution ask the operator to confirm first, and fail closed on clients that cannot prompt. Tool results, exec output and retrieved logs included, pass through secret redaction before they reach the transcript.

You need a Komodo address plus credentials: `KOMODO_URL` with `KOMODO_API_KEY` and `KOMODO_API_SECRET`, or a username and password pair. No credentials means no connection to Komodo. Run it under Docker, via `npx`, or as native Node.js; Docker images cover `amd64`, `arm64`, `arm/v7` and `arm/v6`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KOMODO_URL`, `KOMODO_API_KEY`, `KOMODO_API_SECRET`, `KOMODO_USERNAME`, `KOMODO_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add komodo-mcp-server -e KOMODO_URL=<KOMODO_URL> -e KOMODO_API_KEY=<KOMODO_API_KEY> -e KOMODO_API_SECRET=<KOMODO_API_SECRET> -e KOMODO_USERNAME=<KOMODO_USERNAME> -e KOMODO_PASSWORD=<KOMODO_PASSWORD> -- npx -y komodo-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add komodo-mcp-server --env KOMODO_URL=<KOMODO_URL> --env KOMODO_API_KEY=<KOMODO_API_KEY> --env KOMODO_API_SECRET=<KOMODO_API_SECRET> --env KOMODO_USERNAME=<KOMODO_USERNAME> --env KOMODO_PASSWORD=<KOMODO_PASSWORD> -- npx -y komodo-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "komodo-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "komodo-mcp-server"
            ],
            "env": {
                "KOMODO_URL": "<KOMODO_URL>",
                "KOMODO_API_KEY": "<KOMODO_API_KEY>",
                "KOMODO_API_SECRET": "<KOMODO_API_SECRET>",
                "KOMODO_USERNAME": "<KOMODO_USERNAME>",
                "KOMODO_PASSWORD": "<KOMODO_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "komodo-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "komodo-mcp-server"
            ],
            "env": {
                "KOMODO_URL": "<KOMODO_URL>",
                "KOMODO_API_KEY": "<KOMODO_API_KEY>",
                "KOMODO_API_SECRET": "<KOMODO_API_SECRET>",
                "KOMODO_USERNAME": "<KOMODO_USERNAME>",
                "KOMODO_PASSWORD": "<KOMODO_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KOMODO_URL=<KOMODO_URL> -e KOMODO_API_KEY=<KOMODO_API_KEY> -e KOMODO_API_SECRET=<KOMODO_API_SECRET> -e KOMODO_USERNAME=<KOMODO_USERNAME> -e KOMODO_PASSWORD=<KOMODO_PASSWORD> komodo-mcp-server npx -y komodo-mcp-server
```
Replace <…> with your own values

## When to use it
- list containers and check which ones are down
- deploy a stack or deployment without leaving the chat
- run a command on a server and read the output
- grep container logs for a pattern
- rebuild an image and follow the build log

## Example prompts
- List every container on the server and flag the stopped ones
- Deploy the `web` stack and tell me when it finishes
- Search the `api` container logs for timeout entries in the last 200 lines

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23643
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17160
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md