de en es ja ko ru zh

mcp-komodo

Name: mcp-komodo
Author: Samik081

by Samik081

Overview Schema Related Servers Score Discussions

TypeScript

Remote

npm version License: MIT Node.js Version

MCP Komodo

MCP-сервер для платформы DevOps Komodo. Управляйте серверами, стеками, развертываниями, сборками и многим другим через естественный язык в Cursor, Claude Code и Claude Desktop.

Возможности

63 инструмента в 14 категориях, охватывающих полный API Komodo DevOps
Три уровня доступа (read-only, read-execute, full) для детального контроля
Фильтрация по категориям через KOMODO_CATEGORIES для отображения только нужных инструментов
Ноль HTTP-зависимостей -- легковесный клиент на основе native-fetch, без SDK
Docker-образы для linux/amd64 и linux/arm64 на GHCR
Удаленный MCP через HTTP-транспорт (MCP_TRANSPORT=http) с использованием протокола Streamable HTTP
TypeScript/ESM с полной типовой безопасностью

Related MCP server: komodo-mcp

Совместимость с API

Создано для Komodo 1.19.5.

Быстрый старт

Запустите сервер напрямую с помощью npx:

KOMODO_URL="https://komodo.example.com" \
KOMODO_API_KEY="your-api-key" \
KOMODO_API_SECRET="your-api-secret" \
npx -y @samik081/mcp-komodo

Сервер проверяет ваше подключение к Komodo при запуске и немедленно завершает работу с понятной ошибкой, если учетные данные отсутствуют или недействительны.

Docker

Запуск с Docker (stdio-транспорт, так же как npx):

docker run --rm -i \
  -e KOMODO_URL=https://komodo.example.com \
  -e KOMODO_API_KEY=your-api-key \
  -e KOMODO_API_SECRET=your-api-secret \
  ghcr.io/samik081/mcp-komodo

Для запуска в качестве удаленного MCP-сервера с HTTP-транспортом:

docker run -d -p 3000:3000 \
  -e MCP_TRANSPORT=http \
  -e KOMODO_URL=https://komodo.example.com \
  -e KOMODO_API_KEY=your-api-key \
  -e KOMODO_API_SECRET=your-api-secret \
  ghcr.io/samik081/mcp-komodo

Конечная точка MCP доступна по адресу http://localhost:3000, а проверка работоспособности -- по адресу http://localhost:3000/health.

Конфигурация

Claude Code CLI (рекомендуется):

# Using npx
claude mcp add --transport stdio komodo \
  --env KOMODO_URL=https://komodo.example.com \
  --env KOMODO_API_KEY=your-api-key \
  --env KOMODO_API_SECRET=your-api-secret \
  -- npx -y @samik081/mcp-komodo

# Using Docker
claude mcp add --transport stdio komodo \
  --env KOMODO_URL=https://komodo.example.com \
  --env KOMODO_API_KEY=your-api-key \
  --env KOMODO_API_SECRET=your-api-secret \
  -- docker run --rm -i ghcr.io/samik081/mcp-komodo

# Using remote HTTP (connect to a running Docker container or HTTP server)
claude mcp add --transport http komodo http://localhost:3000

JSON-конфигурация (работает с Claude Code .mcp.json, Claude Desktop claude_desktop_config.json, Cursor .cursor/mcp.json):

{
  "mcpServers": {
    "komodo": {
      "command": "npx",
      "args": ["-y", "@samik081/mcp-komodo"],
      "env": {
        "KOMODO_URL": "https://komodo.example.com",
        "KOMODO_API_KEY": "your-api-key",
        "KOMODO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Docker (stdio):

{
  "mcpServers": {
    "komodo": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "KOMODO_URL=https://komodo.example.com",
        "-e", "KOMODO_API_KEY=your-api-key",
        "-e", "KOMODO_API_SECRET=your-api-secret",
        "ghcr.io/samik081/mcp-komodo"
      ]
    }
  }
}

Удаленный MCP (подключение к запущенному Docker-контейнеру или HTTP-серверу):

{
  "mcpServers": {
    "komodo": {
      "type": "streamable-http",
      "url": "http://localhost:3000"
    }
  }
}

Уровни доступа

Управляйте доступными инструментами с помощью переменной окружения KOMODO_ACCESS_TIER:

Tier	Tools	Description
`full` (default)	63	Чтение, выполнение и запись -- полный контроль
`read-execute`	55	Чтение и выполнение -- без создания/удаления ресурсов, без администрирования пользователей
`read-only`	39	Только чтение -- безопасно для изучения, без изменения состояния

Детали уровней:

full: Все 63 инструмента. Включает komodo_write_resource для создания, обновления и удаления ресурсов Komodo, а также инструменты администрирования пользователей (сервисные пользователи, API-ключи, разрешения).
read-execute: 55 инструментов. Все инструменты чтения плюс инструменты выполнения (deploy, pull, lifecycle, run и т.д.). Инструмент komodo_write_resource и инструменты записи администрирования пользователей скрыты.
read-only: 39 инструментов. Только list, get, logs, inspect, stats, summaries, история операций и чтение пользователей/разрешений. Все инструменты выполнения и записи скрыты.

Инструменты, недоступные в вашем уровне, не регистрируются на MCP-сервере. Они не появятся в списке инструментов вашего ИИ-инструмента, что сохраняет контекст чистым.

Установите KOMODO_ACCESS_TIER в read-only, read-execute или full (по умолчанию: full).

Переменные окружения

Variable	Required	Default	Description
`KOMODO_URL`	Yes	--	URL вашего экземпляра Komodo Core
`KOMODO_API_KEY`	Yes	--	API-ключ для аутентификации
`KOMODO_API_SECRET`	Yes	--	API-секрет для аутентификации
`KOMODO_ACCESS_TIER`	No	`full`	Уровень доступа: `read-only`, `read-execute` или `full`
`KOMODO_CATEGORIES`	No	(all)	Разделенный запятыми список разрешенных категорий (например, `servers,stacks,builds`)
`KOMODO_TOOL_BLACKLIST`	No	(none)	Разделенный запятыми список имен инструментов для исключения (например, `komodo_destroy_stack`)
`KOMODO_TOOL_WHITELIST`	No	(none)	Разделенный запятыми список имен инструментов для принудительного включения, обходя фильтры уровня доступа и категорий
`DEBUG`	No	`false`	Включить отладочное логирование в stderr
`MCP_TRANSPORT`	No	`stdio`	Режим транспорта: `stdio` (по умолчанию) или `http`
`MCP_PORT`	No	`3000`	Порт HTTP-сервера (используется только при `MCP_TRANSPORT=http`)
`MCP_HOST`	No	`0.0.0.0`	Адрес привязки HTTP-сервера (используется только при `MCP_TRANSPORT=http`)
`MCP_EXCLUDE_TOOL_TITLES`	No	`false`	Установите `true`, чтобы исключить заголовки инструментов из регистрации (экономит токены)

Сгенерируйте API-ключи в интерфейсе Komodo в разделе Settings > API Keys.

Доступные категории

servers, stacks, deployments, containers, builds, repos, procedures, actions, builders, alerters, resource-syncs, updates, users, write

Инструменты

mcp-komodo предоставляет 63 инструмента, организованных по категориям. В столбце Access каждого инструмента указан минимальный требуемый уровень: read-only (доступен во всех уровнях), read-execute (требует read-execute или full) или full (только для уровня full). В столбце Hints указано поведение инструмента: read-only (без изменения состояния), destructive (изменяет существующее состояние), idempotent (одинаковый результат при повторном вызове).

Все 16 инструментов выполнения по умолчанию ожидают завершения операции и сообщают о ее реальном результате; передайте wait: false для запуска без ожидания или wait_timeout_seconds для ограничения времени ожидания (по умолчанию 45 секунд).

Tool	Description	Access	Hints
`komodo_list_servers`	Список всех серверов с статусом и регионом	read-only	read-only, idempotent
`komodo_get_server`	Получить конфигурацию сервера, статус и состояние действий	read-only	read-only, idempotent
`komodo_get_server_stats`	Получить использование CPU, памяти, диска и средние нагрузки	read-only	read-only, idempotent
`komodo_get_server_info`	Получить сведения об ОС, аппаратном обеспечении и запущенных процессах	read-only	read-only, idempotent
`komodo_inspect_docker_container`	Проверить Docker-контейнер (полезная нагрузка `docker inspect`); значения env отображаются как дайджесты `sha256:<12-hex>`, если не указано `show_env_values: true` -- редактирование затрагивает только массивы `Env`, поэтому labels, cmd и mounts возвращаются без редактирования	read-only	read-only, idempotent
`komodo_inspect_docker_image`	Проверить Docker-образ (полезная нагрузка `docker image inspect`); встроенные значения env отображаются как дайджесты `sha256:<12-hex>`, если не указано `show_env_values: true` -- редактирование затрагивает только массивы `Env`, поэтому labels, cmd и layers возвращаются без редактирования	read-only	read-only, idempotent
`komodo_inspect_docker_network`	Проверить Docker-сеть (эквивалент docker network inspect)	read-only	read-only, idempotent
`komodo_inspect_docker_volume`	Проверить Docker-том (эквивалент docker volume inspect)	read-only	read-only, idempotent
`komodo_prune_docker`	Очистить неиспользуемые Docker-ресурсы на сервере	read-execute	destructive, idempotent
`komodo_delete_docker_resource`	Удалить конкретный Docker-образ, том или сеть	read-execute	destructive

Инструмент	Описание	Доступ	Подсказки
`komodo_list_stacks`	Список всех стеков с состоянием, сервером и количеством сервисов	только чтение	только чтение, идемпотентный
`komodo_get_stack`	Получить конфигурацию стека, сервисы и состояние действий	только чтение	только чтение, идемпотентный
`komodo_list_stack_services`	Список сервисов в стеке с образом, состоянием контейнера и доступностью обновлений	только чтение	только чтение, идемпотентный
`komodo_get_stacks_summary`	Получить агрегированные подсчеты всех стеков по состоянию	только чтение	только чтение, идемпотентный
`komodo_get_stack_log`	Получить журналы сервисов стека с возможностью поиска	только чтение	только чтение, идемпотентный
`komodo_inspect_stack_container`	Проверить контейнер для конкретного сервиса в стеке (полезная нагрузка `docker inspect`); значения env отображаются как дайджесты `sha256:<12-hex>`, если только `show_env_values: true` — редактирование охватывает только массивы `Env`, поэтому labels, cmd и mounts возвращаются без редактирования	только чтение	только чтение, идемпотентный
`komodo_deploy_stack`	Развернуть или повторно развернуть стек	чтение-выполнение	разрушительный
`komodo_pull_stack`	Получить последние образы без повторного развертывания (docker compose pull)	чтение-выполнение	идемпотентный
`komodo_stack_lifecycle`	Запустить, остановить, перезапустить, приостановить или возобновить стек; при необходимости нацелен на конкретные сервисы	чтение-выполнение	разрушительный
`komodo_destroy_stack`	Навсегда уничтожить стек	чтение-выполнение	разрушительный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_deployments`	Список всех развертываний с состоянием, образом и сервером	только чтение	только чтение, идемпотентный
`komodo_get_deployment`	Получить конфигурацию развертывания, статус контейнера и состояние действий	только чтение	только чтение, идемпотентный
`komodo_get_deployments_summary`	Получить агрегированные подсчеты всех развертываний по состоянию	только чтение	только чтение, идемпотентный
`komodo_get_deployment_log`	Получить журналы контейнера с возможностью поиска	только чтение	только чтение, идемпотентный
`komodo_inspect_deployment_container`	Проверить контейнер для развертывания (полезная нагрузка `docker inspect`); значения env отображаются как дайджесты `sha256:<12-hex>`, если только `show_env_values: true` — редактирование охватывает только массивы `Env`, поэтому labels, cmd и mounts возвращаются без редактирования	только чтение	только чтение, идемпотентный
`komodo_deploy_deployment`	Развернуть с последним образом и конфигурацией	чтение-выполнение	разрушительный
`komodo_pull_deployment`	Получить последний образ без повторного развертывания (docker pull)	чтение-выполнение	идемпотентный
`komodo_deployment_lifecycle`	Запустить, остановить, перезапустить, приостановить или возобновить развертывание	чтение-выполнение	разрушительный
`komodo_destroy_deployment`	Навсегда уничтожить развертывание	чтение-выполнение	разрушительный

Инструмент	Описание	Доступ	Подсказки
`komodo_get_container_log`	Получить журналы любого контейнера Docker на сервере	только чтение	только чтение, идемпотентный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_builds`	Список всех конфигураций сборки с информацией о версии	только чтение	только чтение, идемпотентный
`komodo_get_build`	Получить конфигурацию сборки, сборщик и состояние действий	только чтение	только чтение, идемпотентный
`komodo_run_build`	Запустить сборку для создания образа Docker	чтение-выполнение	—
`komodo_cancel_build`	Отменить выполняемую сборку	чтение-выполнение	разрушительный, идемпотентный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_repos`	Список всех репозиториев с URL, сервером и состоянием	только чтение	только чтение, идемпотентный
`komodo_get_repo`	Получить конфигурацию репозитория, ветку и состояние действий	только чтение	только чтение, идемпотентный
`komodo_repo_clone_pull`	Клонировать или получить репозиторий на целевом сервере	чтение-выполнение	разрушительный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_procedures`	Список всех процедур с состоянием	только чтение	только чтение, идемпотентный
`komodo_get_procedure`	Получить этапы процедуры, операции и состояние действий	только чтение	только чтение, идемпотентный
`komodo_run_procedure`	Запустить процедуру (выполняет все этапы)	чтение-выполнение	разрушительный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_actions`	Список всех действий с состоянием	только чтение	только чтение, идемпотентный
`komodo_get_action`	Получить конфигурацию действия и состояние действий	только чтение	только чтение, идемпотентный
`komodo_run_action`	Запустить пользовательское действие TypeScript/Deno	чтение-выполнение	разрушительный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_builders`	Список всех сборщиков с типом	только чтение	только чтение, идемпотентный
`komodo_get_builder`	Получить тип сборщика, конфигурацию сервера и состояние	только чтение	только чтение, идемпотентный

Инструмент	Описание	Доступ	Подсказки
`komodo_list_alerters`	Список всех оповещателей с типом	только чтение	только чтение, идемпотентный
`komodo_get_alerter`	Получить тип конечной точки оповещателя, конфигурацию и статус	только чтение	только чтение, идемпотентный

Tool	Описание	Доступ	Подсказки
`komodo_list_resource_syncs`	Список всех синхронизаций ресурсов с состоянием и информацией о репозитории	read-only	read-only, идемпотентный
`komodo_get_resource_sync`	Получить конфигурацию синхронизации, управляемые ресурсы и состояние	read-only	read-only, идемпотентный
`komodo_trigger_sync`	Запустить синхронизацию GitOps из Git-репозитория	read-execute	разрушительный

Tool	Описание	Доступ	Подсказки
`komodo_list_updates`	Список истории операций с фильтрами по типу ресурса, цели, операции и успешности	read-only	read-only, идемпотентный
`komodo_get_update`	Получить полные сведения об операции, включая журналы со stdout/stderr для каждого этапа	read-only	read-only, идемпотентный

Все 10 инструментов раздела «Пользователи» требуют учётную запись администратора Komodo — Komodo отклоняет их для API-ключей без прав администратора, независимо от настроенного уровня доступа.

Tool	Описание	Доступ	Подсказки
`komodo_list_users`	Список пользователей Komodo с возможностью фильтрации сервисных пользователей	read-only	read-only, идемпотентный
`komodo_list_api_keys_for_service_user`	Список API-ключей сервисного пользователя (секреты никогда не возвращаются)	read-only	read-only, идемпотентный
`komodo_list_permissions`	Список разрешений, выданных пользователю или группе пользователей	read-only	read-only, идемпотентный
`komodo_create_service_user`	Создать сервисного пользователя для автоматизации	full	—
`komodo_delete_user`	Удалить пользователя по ID или имени пользователя	full	разрушительный
`komodo_create_api_key_for_service_user`	Создать API-ключ для сервисного пользователя (секрет возвращается один раз)	full	—
`komodo_delete_api_key_for_service_user`	Удалить API-ключ сервисного пользователя	full	разрушительный
`komodo_update_user_base_permissions`	Обновить флаги пользователя `enabled` / `create-servers` / `create-builds`	full	разрушительный, идемпотентный
`komodo_update_permission_on_resource_type`	Задать базовое разрешение пользователя или группы на все ресурсы определённого типа	full	разрушительный, идемпотентный
`komodo_update_permission_on_target`	Задать разрешение пользователя или группы на один конкретный ресурс	full	разрушительный, идемпотентный

Tool	Описание	Доступ	Подсказки
`komodo_write_resource`	Создать, обновить или удалить любой ресурс Komodo	full	—

Проверка работоспособности

После настройки MCP-клиента спросите своего ИИ-ассистента:

"Какие серверы подключены к Komodo?"

Если подключение работает, ассистент вызовет komodo_list_servers и вернёт ваши серверы с их текущим состоянием и регионом.

Примеры использования

После настройки задавайте своему ИИ-инструменту вопросы на естественном языке:

"Список всех моих серверов и их статус" — вызывает komodo_list_servers, чтобы показать все серверы с их текущим состоянием и регионом.
"Какая нагрузка на процессор и память на сервере prod-01?" — вызывает komodo_get_server_stats, чтобы показать использование ресурсов в реальном времени.
"Покажи журналы рабочего стека" — вызывает komodo_get_stack_log, чтобы получить последние выводы журнала от всех сервисов в стеке.
"Разверни фронтенд-стек" — вызывает komodo_deploy_stack, чтобы повторно развернуть стек с его текущей конфигурацией.
"Почему развёртывание фронтенд-стека не удалось?" — вызывает komodo_list_updates, чтобы найти неудачное развёртывание, затем komodo_get_update показывает полную логику со stdout/stderr.
"Подтяни последние образы для мониторинг-стека" — вызывает komodo_pull_stack, чтобы загрузить обновлённые образы без повторного развёртывания.
"Создай новый деплоймент под названием api-staging с образом myapp:latest" — вызывает komodo_write_resource, чтобы создать новый ресурс Deployment в Komodo.

Устранение неполадок

Отказ в подключении

Проверьте, что KOMODO_URL указан правильно и что Komodo Core доступен с машины, где запущен MCP-сервер. Сервер проверяет подключение при запуске, поэтому если он запустился успешно, URL на тот момент был валидным.

Неверные учётные данные / 401 Unauthorized

Убедитесь, что ваш API-ключ и секрет корректны. Проверьте, что ключ не отозван и не истёк в интерфейсе Komodo в разделе Settings > API Keys.

Инструменты не отображаются

Проверьте настройку уровня доступа. В режиме read-only регистрируются только 39 инструментов. В режиме read-execute регистрируются 55 инструментов. Используйте full (или опустите KOMODO_ACCESS_TIER) для получения всех 63 инструментов. Проверьте KOMODO_CATEGORIES — регистрируются только инструменты из перечисленных категорий. Также убедитесь, что сервер запустился без ошибок, проверив stderr.

Разработка

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode (auto-reload)
npm run dev

# Open the MCP Inspector for interactive testing
npm run inspect

Лицензия

MIT

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

25Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Komodo MCP Server
CI/CD & DevOps Monitoring Cloud Platforms
Secure-ISS
F
license
Not graded
quality
Not graded
maintenance
Enables natural language management of servers, deployments, and build pipelines through the Komodo infrastructure platform. It provides over 60 tools for automated workflows, real-time monitoring, and secure HMAC-authenticated infrastructure control.
Updated 7 months ago (2026-01-26 23:08 UTC)
komodo-mcp
Virtualization Cloud Platforms Developer Tools
digital-grease
A
license
Not graded
quality
F
maintenance
An MCP server that exposes the full API of the Komodo infrastructure management platform. It enables users to manage deployments, stacks, servers, and containers through tools for inspection, configuration, and operational control.
Updated 5 months ago (2026-03-29 02:57 UTC)
MIT
mcpdeployment
Developer Tools Agent Orchestration
manutrip-pm-AI-Defense
F
license
C
quality
D
maintenance
MCP server that enables deployment and management of MCP servers through a simple configuration-based interface.
Updated 3 months ago (2026-05-19 09:38 UTC)
1
komodo-mcp
Cloud Platforms Virtualization CI/CD & DevOps
MyrikLD
F
license
Not graded
quality
C
maintenance
Manage Komodo DevOps platform resources (servers, containers, stacks, builds) directly from AI assistants via MCP protocol. Supports OAuth 2.1 and easy Docker Compose deployment.
Updated 16 days ago (2026-08-07 13:09 UTC)
13

View all related MCP servers

Related MCP Connectors

Azure DevOps (ADO)
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Appcircle MCP
MCP server for Appcircle mobile CI/CD platform.
neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Samik081/mcp-komodo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server