convez.ai
MCP Server
nikitatsym

komodo-mcp

nikitatsym/komodo-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for Komodo — 293 tools for full API coverage

Instalação

$npx convez-ai nikitatsym/komodo-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 6 dias
Versão
v1.0.30
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

komodo-mcp

MCP server for Komodo — full API coverage for autonomous AI agents.

293 tools covering every Komodo Core operation: servers, deployments, stacks, builds, repos, procedures, actions, resource syncs, Docker management, users, permissions, and more. Compact mode available (6 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.

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.

Configuration

VariableDescription
KOMODO_URLBase URL of your Komodo Core instance
KOMODO_API_KEYAPI key for authentication
KOMODO_API_SECRETAPI secret for authentication
KOMODO_COMPACTSet to true for compact mode (3 meta-tools instead of 293)

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 293 individual tools, it exposes 6 meta-tools split by risk level, with built-in help discovery:

ToolScopeOps
komodo_readSafe resource queries109
komodo_writeCreate/update/rename/copy (non-destructive)68
komodo_executeDeploy, start/stop, build (actions)48
komodo_deleteDelete, destroy, prune (destructive)36
komodo_admin_readUser/permission queries10
komodo_admin_writeUser/permission management, admin-only22
{
  "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. Users can selectively allow safe tools (read) while blocking destructive ones (delete, admin).

Tools Overview

Read (119 tools)

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.

Write (108 tools)

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

Execute (66 tools)

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

Ver o original no GitHub

Bom para

Relacionados