Skip to main content
Glama
deenesjakoruzh
Samik081

mcp-komodo

by Samik081
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

npm version Docker image License: MIT Node.js Version

MCP Komodo

Komodo DevOps プラットフォーム用の MCP サーバー。Cursor、Claude Code、Claude Desktop で自然言語を通じてサーバー、スタック、デプロイ、ビルドなどを管理します。

特徴

  • 14 カテゴリにわたる 63 のツールが完全な Komodo DevOps API をカバー

  • 3 つのアクセス層（read-only、read-execute、full）できめ細かく制御

  • KOMODO_CATEGORIES によるカテゴリフィルタリングで、必要なツールだけを公開

  • HTTP 依存ゼロ -- 軽量なネイティブ fetch クライアント、SDK 不要

  • GHCR で linux/amd64 と linux/arm64 の** Docker イメージ**を提供

  • Streamable HTTP プロトコルを使用した HTTP トランスポート（MCP_TRANSPORT=http）によるリモート MCP 対応

  • 完全な型安全性を備えた 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

HTTP トランスポートでリモート MCP サーバーとして実行する場合:

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 環境変数を使用して、利用可能なツールを制御します:

層

ツール数

説明

full（デフォルト）

63

読み取り、実行、書き込み -- フルコントロール

read-execute

55

読み取りと実行 -- リソースの作成・削除、ユーザー管理は不可

read-only

39

読み取りのみ -- 探索に安全、状態の変更なし

層の詳細:

  • full: 全 63 ツール。Komodo リソースの作成・更新・削除を行う komodo_write_resource に加え、ユーザー管理ツール（サービスユーザー、API キー、権限）を含みます。

  • read-execute: 55 ツール。すべての読み取りツールに加え、実行ツール（デプロイ、プル、ライフサイクル、実行など）を含みます。komodo_write_resource ツールとユーザー管理の書き込みツールは非表示になります。

  • read-only: 39 ツール。一覧、取得、ログ、検査、統計、サマリー、操作履歴、ユーザー・権限の読み取りのみです。すべての実行ツールと書き込みツールは非表示になります。

お使いの層で利用できないツールは MCP サーバーに登録されません。AI ツールのツールリストに表示されないため、コンテキストをクリーンに保てます。

KOMODO_ACCESS_TIER を read-only、read-execute、full のいずれかに設定します（デフォルト: full）。

環境変数

変数

必須

デフォルト

説明

KOMODO_URL

はい

--

Komodo Core インスタンスの URL

KOMODO_API_KEY

はい

--

認証用の API キー

KOMODO_API_SECRET

はい

--

認証用の API シークレット

KOMODO_ACCESS_TIER

いいえ

full

アクセス層: read-only、read-execute、full

KOMODO_CATEGORIES

いいえ

(すべて)

カンマ区切りのカテゴリ許可リスト（例: servers,stacks,builds）

KOMODO_TOOL_BLACKLIST

いいえ

(なし)

除外するツール名のカンマ区切りリスト（例: komodo_destroy_stack）

KOMODO_TOOL_WHITELIST

いいえ

(なし)

アクセス層とカテゴリフィルタをバイパスして強制的に含めるツール名のカンマ区切りリスト

DEBUG

いいえ

false

stderr へのデバッグログを有効にする

MCP_TRANSPORT

いいえ

stdio

トランスポートモード: stdio（デフォルト）または http

MCP_PORT

いいえ

3000

HTTP サーバーのポート（MCP_TRANSPORT=http の場合のみ使用）

MCP_HOST

いいえ

0.0.0.0

HTTP サーバーのバインドアドレス（MCP_TRANSPORT=http の場合のみ使用）

MCP_EXCLUDE_TOOL_TITLES

いいえ

false

登録からツールタイトルを除外するには true に設定（トークンを節約）

API キーは Komodo UI の 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（2 回呼び出しても同じ結果）。

16 個すべての実行ツールは、デフォルトで操作の完了を待機して実際の結果を報告します。ファイアアンドフォーゲットの場合は wait: false を、待機時間を制限する場合は wait_timeout_seconds を渡します（デフォルト 45 秒）。

ツール

説明

アクセス

ヒント

komodo_list_servers

ステータスとリージョンを指定して全サーバーを一覧表示する

read-only

read-only、冪等

komodo_get_server

サーバー設定、ステータス、アクション状態を取得する

read-only

read-only、冪等

komodo_get_server_stats

CPU、メモリ、ディスク使用量、ロードアベレージを取得する

read-only

read-only、冪等

komodo_get_server_info

OS の詳細、ハードウェア情報、実行中のプロセスを取得する

read-only

read-only、冪等

komodo_inspect_docker_container

Docker コンテナを検査する（docker inspect ペイロード）。show_env_values: true を指定しない限り、env 値は sha256:<12桁の16進数> ダイジェストとして表示される -- マスキングは Env 配列のみを対象とするため、ラベル、cmd、マウントはマスキングされずに返される

read-only

read-only、冪等

komodo_inspect_docker_image

Docker イメージを検査する（docker image inspect ペイロード）。組み込みの env 値は show_env_values: true を指定しない限り sha256:<12桁の16進数> ダイジェストとして表示される -- マスキングは Env 配列のみを対象とするため、ラベル、cmd、レイヤーはマスキングされずに返される

read-only

read-only、冪等

komodo_inspect_docker_network

Docker ネットワークを検査する（docker network inspect と同等）

read-only

read-only、冪等

komodo_inspect_docker_volume

Docker ボリュームを検査する（docker volume inspect と同等）

read-only

read-only、冪等

komodo_prune_docker

サーバー上の未使用の Docker リソースを削除する

read-execute

破壊的、冪等

komodo_delete_docker_resource

特定の Docker イメージ、ボリューム、またはネットワークを削除する

read-execute

破壊的

ツール

説明

アクセス

ヒント

komodo_list_stacks

状態、サーバー、サービス数を含むすべてのスタックを一覧表示

読み取り専用

読み取り専用、冪等

komodo_get_stack

スタックの設定、サービス、アクション状態を取得

読み取り専用

読み取り専用、冪等

komodo_list_stack_services

イメージ、コンテナ状態、更新の有無を含むスタック内のサービスを一覧表示

読み取り専用

読み取り専用、冪等

komodo_get_stacks_summary

状態別の全スタックの集計数を取得

読み取り専用

読み取り専用、冪等

komodo_get_stack_log

スタックサービスのログを取得（検索オプション付き）

読み取り専用

読み取り専用、冪等

komodo_inspect_stack_container

スタック内の特定サービスのコンテナを検査（docker inspect ペイロード）。show_env_values: true でない限り、環境変数の値は sha256:<12-hex> ダイジェストとして表示される。編集（マスキング）は 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 ペイロード）。show_env_values: true でない限り、環境変数の値は sha256:<12-hex> ダイジェストとして表示される。編集（マスキング）は 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

アラート送信先のエンドポイントタイプ、設定、ステータスを取得

読み取り専用

読み取り専用、冪等

ツール

説明

アクセス

ヒント

komodo_list_resource_syncs

すべてのリソース同期を状態とリポジトリ情報とともに一覧表示します

読み取り専用

読み取り専用、冪等

komodo_get_resource_sync

同期設定、管理対象リソース、および状態を取得します

読み取り専用

読み取り専用、冪等

komodo_trigger_sync

GitリポジトリからGitOps同期をトリガーします

読み取り・実行

破壊的

ツール

説明

アクセス

ヒント

komodo_list_updates

リソースタイプ、ターゲット、操作、成功/失敗のフィルターで操作履歴を一覧表示します

読み取り専用

読み取り専用、冪等

komodo_get_update

各ステージのstdout/stderrを含むログ付きの完全な操作詳細を取得します

読み取り専用

読み取り専用、冪等

10個のユーザーツールはすべてKomodo管理者アカウントを必要とします -- Komodoは、設定されたアクセスレベルに関係なく、非管理者のAPIキーを拒否します。

ツール

説明

アクセス

ヒント

komodo_list_users

Komodoユーザーを一覧表示します。オプションでサービスユーザーをフィルタリングできます

読み取り専用

読み取り専用、冪等

komodo_list_api_keys_for_service_user

サービスユーザーのAPIキーを一覧表示します（シークレットは決して返されません）

読み取り専用

読み取り専用、冪等

komodo_list_permissions

ユーザーまたはユーザーグループに付与された権限を一覧表示します

読み取り専用

読み取り専用、冪等

komodo_create_service_user

自動化用のサービスユーザーを作成します

フル

—

komodo_delete_user

IDまたはユーザー名でユーザーを削除します

フル

破壊的

komodo_create_api_key_for_service_user

サービスユーザーのAPIキーを作成します（シークレットは一度だけ返されます）

フル

—

komodo_delete_api_key_for_service_user

サービスユーザーのAPIキーを削除します

フル

破壊的

komodo_update_user_base_permissions

ユーザーのenabled / create-servers / create-buildsフラグを更新します

フル

破壊的、冪等

komodo_update_permission_on_resource_type

ユーザーまたはグループの基本権限を、特定タイプのすべてのリソースに設定します

フル

破壊的、冪等

komodo_update_permission_on_target

ユーザーまたはグループの権限を、特定の1つのリソースに設定します

フル

破壊的、冪等

ツール

説明

アクセス

ヒント

komodo_write_resource

任意のKomodoリソースを作成、更新、または削除します

フル

破壊的

動作確認

MCPクライアントを設定したら、AIアシスタントに次のように尋ねてください：

「Komodoに接続されているサーバーはどれですか？」

接続が機能している場合、アシスタントはkomodo_list_serversを呼び出し、各サーバーを現在の状態とリージョンとともに返します。

使用例

設定後、AIツールに自然言語で質問してください：

  • 「すべてのサーバーとそのステータスを一覧表示して」 -- komodo_list_serversを呼び出し、すべてのサーバーを現在の状態とリージョンとともに表示します。

  • 「サーバーprod-01のCPUとメモリ使用量は？」 -- komodo_get_server_statsを呼び出し、リアルタイムのリソース使用状況を表示します。

  • 「本番スタックのログを表示して」 -- komodo_get_stack_logを呼び出し、スタック内のすべてのサービスの最近のログ出力を取得します。

  • 「フロントエンドスタックをデプロイして」 -- komodo_deploy_stackを呼び出し、現在の構成でスタックを再デプロイします。

  • 「フロントエンドスタックのデプロイが失敗したのはなぜ？」 -- komodo_list_updatesを呼び出して失敗したデプロイを特定し、次にkomodo_get_updateを呼び出してstdout/stderrを含む完全なログを表示します。

  • 「モニタリングスタックの最新イメージをプルして」 -- komodo_pull_stackを呼び出し、再デプロイせずに更新されたイメージをダウンロードします。

  • 「イメージmyapp:latestを使用してapi-stagingという新しいデプロイメントを作成して」 -- komodo_write_resourceを呼び出し、Komodoに新しいDeploymentリソースを作成します。

トラブルシューティング

接続拒否

KOMODO_URLが正しいこと、およびMCPサーバーが実行されている場所からKomodo Coreに到達可能であることを確認してください。サーバーは起動時に接続を検証するため、正常に起動した場合は、その時点でURLは有効でした。

資格情報が無効 / 401 Unauthorized

APIキーとシークレットが正しいことを確認してください。Komodo UIのSettings > API Keysで、キーが失効または期限切れになっていないか確認してください。

ツールが表示されない

アクセスレベルの設定を確認してください。read-onlyモードでは39個のツールのみが登録されます。read-executeモードでは55個のツールが登録されます。全63個のツールを使用するにはfullを使用します（またはKOMODO_ACCESS_TIERを省略します）。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

A
license - permissive license
Not graded
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1wRelease cycle
25Releases (12mo)
Commit activity

Resources

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

    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.

  • komodo-mcp

    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.
    MIT

  • komodo-mcp

    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.
    13

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

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