Komodo MCP 服务器

komodo-mcp

MCP server for Komodo, built for autonomous AI agents.

Servers, deployments, stacks, builds, repos, procedures, actions, resource syncs, Docker management, users, permissions, and more — one tool per operation, or compact mode with risk-graded meta-tools.

Long-running waiters: every execute op returns an Update; UpdatesWait blocks until it completes, UpdatesWaitStart / UpdatesWaitPoll(max_block=...) / UpdatesWaitCancel + WaitsList keep the agent responsive. Waits tolerate transient API errors (max_poll_failures), self-terminate after max_lifetime (default 2h), and live in komodo_read - they only ever read. Stage logs default to failed stages only (failed_only=True); logs_omitted counts the hidden ones.

Quick Start

Add to your MCP client config:

{
  "mcpServers": {
    "komodo": {
      "command": "uvx",
      "args": ["--refresh", "--extra-index-url",
        "https://nikitatsym.github.io/komodo-mcp/simple",
        "komodo-mcp"],
      "env": {
        "KOMODO_URL": "https://komodo.example.com",
        "KOMODO_API_KEY": "your-api-key",
        "KOMODO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Or use the interactive config generator.

HTTP

komodo-mcp --http serves streamable HTTP at http://127.0.0.1:8000/mcp (--host, --port) instead of stdio, same environment variables. No authentication: put a gateway in front.

The package can also be imported: mcp, Settings, the client class, and client_var (a ContextVar the host sets per request) let one process serve several instances.

Configuration

Getting API Credentials

1. Open your Komodo dashboard
2. Go to Settings → API Keys
3. Create a new API key (or create a Service User first)
4. Copy the Key and Secret

Compact Mode

If you have many MCP servers and want to reduce total tool count, set KOMODO_COMPACT=true. Instead of one tool per operation, it exposes meta-tools split by risk level, with built-in help discovery:

{
  "mcpServers": {
    "komodo": {
      "command": "uvx",
      "args": ["--refresh", "--extra-index-url",
        "https://nikitatsym.github.io/komodo-mcp/simple",
        "komodo-mcp"],
      "env": {
        "KOMODO_URL": "https://komodo.example.com",
        "KOMODO_API_KEY": "your-api-key",
        "KOMODO_API_SECRET": "your-api-secret",
        "KOMODO_COMPACT": "true"
      }
    }
  }
}

The LLM calls any tool with operation="help" to discover available operations, then calls with the specific operation name and params JSON. params={"search": "log"} narrows help to operations whose name or description contains the substring (case-insensitive) and names matches in other tools. Users can selectively allow safe tools (read) while blocking destructive ones (delete, admin).

Tools Overview

Read

Query servers, deployments, stacks, builds, repos, procedures, actions, resource syncs, builders, alerters, Docker containers/images/networks/volumes, tags, variables, users, permissions, updates, alerts, and more.

Variable and provider-account operations mask secret variable values and tokens (# per character, as Komodo shows them to non-admins) in every group except komodo_admin_read, where RevealVariable and the provider-account reads return them. TOML exports mask secret variables too, so applying such an export through a sync overwrites them with the mask. This guards against accidental exposure, not against an agent with an admin API key: container inspection (Env with interpolated secrets), resource configs, and logs are returned as Komodo sends them.

Write

Create, update, delete, rename, and copy all resource types. Manage webhooks, variables, tags, users, user groups, permissions, and provider accounts.

Execute

Deploy, start, stop, restart, pause, unpause, and destroy deployments and stacks. Run builds, clone/pull repos, execute procedures and actions, sync resources. Docker cleanup (prune). Batch operations. Send alerts, backup database.

Running Tests

# Start test infrastructure
docker compose -f tests/docker-compose.yml up -d

# Run integration tests
uv run pytest tests/ -v

# Tear down
docker compose -f tests/docker-compose.yml down -v

License

MIT