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

Komodo DevOps 플랫폼용 MCP 서버입니다. Cursor, Claude Code, Claude Desktop에서 자연어로 서버, 스택, 배포, 빌드 등을 관리하세요.

기능

14개 카테고리에 걸친 63개 도구로 Komodo DevOps API 전체를 다룹니다.
세분화된 제어를 위한 세 가지 액세스 등급 (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`로 설정 (토큰 절약)

Komodo UI의 설정 > API 키에서 API 키를 생성하세요.

사용 가능한 카테고리

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개의 실행 도구는 기본적으로 작업이 완료될 때까지 대기하고 실제 결과를 보고합니다. fire-and-forget을 원하면 wait: false를 전달하고, 대기 시간을 제한하려면 wait_timeout_seconds를 전달하세요(기본 45초).

도구	설명	액세스	힌트
`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`	OS 세부 정보, 하드웨어 정보 및 실행 중인 프로세스 가져오기	read-only	read-only, idempotent
`komodo_inspect_docker_container`	Docker 컨테이너 검사(`docker inspect` 페이로드); `show_env_values: true`가 아니면 env 값은 `sha256:<12-hex>` 다이제스트로 표시됩니다. 편집은 `Env` 배열에만 적용되므로 labels, cmd, mounts는 편집되지 않은 채 반환됩니다.	read-only	read-only, idempotent
`komodo_inspect_docker_image`	Docker 이미지 검사(`docker image inspect` 페이로드); `show_env_values: true`가 아니면 내장된 env 값은 `sha256:<12-hex>` 다이제스트로 표시됩니다. 편집은 `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

Tool	Description	Access	Hints
`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`가 아닌 한 env 값은 `sha256:<12-hex>` 다이제스트로 표시됩니다. -- 마스킹은 `Env` 배열에만 적용되므로 labels, cmd, mounts는 마스킹되지 않은 채 반환됩니다	읽기 전용	읽기 전용, 멱등
`komodo_deploy_stack`	스택을 배포하거나 재배포합니다	읽기/실행	파괴적
`komodo_pull_stack`	재배포 없이 최신 이미지를 가져옵니다 (docker compose pull)	읽기/실행	멱등
`komodo_stack_lifecycle`	스택을 시작, 중지, 재시작, 일시 중지 또는 일시 중지 해제합니다. 선택적으로 특정 서비스를 대상으로 지정할 수 있습니다	읽기/실행	파괴적
`komodo_destroy_stack`	스택을 영구적으로 삭제합니다	읽기/실행	파괴적

Tool	Description	Access	Hints
`komodo_list_deployments`	상태, 이미지, 서버와 함께 모든 배포를 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_deployment`	배포 구성, 컨테이너 상태 및 작업 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_get_deployments_summary`	상태별 모든 배포의 집계 수를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_get_deployment_log`	선택적 검색과 함께 컨테이너 로그를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_inspect_deployment_container`	배포의 컨테이너를 검사합니다(`docker inspect` 페이로드). `show_env_values: true`가 아닌 한 env 값은 `sha256:<12-hex>` 다이제스트로 표시됩니다. -- 마스킹은 `Env` 배열에만 적용되므로 labels, cmd, mounts는 마스킹되지 않은 채 반환됩니다	읽기 전용	읽기 전용, 멱등
`komodo_deploy_deployment`	최신 이미지와 구성으로 배포합니다	읽기/실행	파괴적
`komodo_pull_deployment`	재배포 없이 최신 이미지를 가져옵니다 (docker pull)	읽기/실행	멱등
`komodo_deployment_lifecycle`	배포를 시작, 중지, 재시작, 일시 중지 또는 일시 중지 해제합니다	읽기/실행	파괴적
`komodo_destroy_deployment`	배포를 영구적으로 삭제합니다	읽기/실행	파괴적

Tool	Description	Access	Hints
`komodo_get_container_log`	서버의 모든 Docker 컨테이너에서 로그를 가져옵니다	읽기 전용	읽기 전용, 멱등

Tool	Description	Access	Hints
`komodo_list_builds`	버전 정보와 함께 모든 빌드 구성을 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_build`	빌드 구성, 빌더 및 작업 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_run_build`	Docker 이미지를 생성하기 위해 빌드를 실행합니다	읽기/실행	—
`komodo_cancel_build`	실행 중인 빌드를 취소합니다	읽기/실행	파괴적, 멱등

Tool	Description	Access	Hints
`komodo_list_repos`	URL, 서버, 상태와 함께 모든 저장소를 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_repo`	저장소 구성, 브랜치 및 작업 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_repo_clone_pull`	대상 서버에서 저장소를 클론하거나 풀합니다	읽기/실행	파괴적

Tool	Description	Access	Hints
`komodo_list_procedures`	상태와 함께 모든 프로시저를 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_procedure`	프로시저 단계, 작업 및 작업 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_run_procedure`	프로시저를 실행합니다 (모든 단계를 실행)	읽기/실행	파괴적

Tool	Description	Access	Hints
`komodo_list_actions`	상태와 함께 모든 작업을 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_action`	작업 구성 및 작업 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등
`komodo_run_action`	사용자 지정 TypeScript/Deno 작업을 실행합니다	읽기/실행	파괴적

Tool	Description	Access	Hints
`komodo_list_builders`	유형과 함께 모든 빌더를 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_builder`	빌더 유형, 서버 구성 및 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등

Tool	Description	Access	Hints
`komodo_list_alerters`	유형과 함께 모든 알리터를 나열합니다	읽기 전용	읽기 전용, 멱등
`komodo_get_alerter`	알리터 엔드포인트 유형, 구성 및 상태를 가져옵니다	읽기 전용	읽기 전용, 멱등

도구	설명	액세스	힌트
`komodo_list_resource_syncs`	상태 및 저장소 정보와 함께 모든 리소스 동기화 나열	read-only	read-only, idempotent
`komodo_get_resource_sync`	동기화 구성, 관리 리소스 및 상태 가져오기	read-only	read-only, idempotent
`komodo_trigger_sync`	Git 저장소에서 GitOps 동기화 트리거	read-execute	destructive

도구	설명	액세스	힌트
`komodo_list_updates`	리소스 유형, 대상, 작업, 성공 여부 필터를 사용하여 작업 기록 나열	read-only	read-only, idempotent
`komodo_get_update`	각 단계의 stdout/stderr 로그를 포함한 전체 작업 세부 정보 가져오기	read-only	read-only, idempotent

사용자 도구 10개는 모두 Komodo 관리자 계정이 필요합니다. Komodo는 구성된 액세스 등급과 관계없이 관리자 권한이 없는 API 키를 거부합니다.

도구	설명	액세스	힌트
`komodo_list_users`	Komodo 사용자 나열, 선택적으로 서비스 사용자 필터링	read-only	read-only, idempotent
`komodo_list_api_keys_for_service_user`	서비스 사용자의 API 키 나열(시크릿은 절대 반환되지 않음)	read-only	read-only, idempotent
`komodo_list_permissions`	사용자 또는 사용자 그룹에 부여된 권한 나열	read-only	read-only, idempotent
`komodo_create_service_user`	자동화를 위한 서비스 사용자 생성	full	—
`komodo_delete_user`	ID 또는 사용자 이름으로 사용자 삭제	full	destructive
`komodo_create_api_key_for_service_user`	서비스 사용자용 API 키 생성(시크릿은 한 번만 반환됨)	full	—
`komodo_delete_api_key_for_service_user`	서비스 사용자의 API 키 삭제	full	destructive
`komodo_update_user_base_permissions`	사용자의 enabled / create-servers / create-builds 플래그 업데이트	full	destructive, idempotent
`komodo_update_permission_on_resource_type`	특정 유형의 모든 리소스에 대한 사용자 또는 그룹의 기본 권한 설정	full	destructive, idempotent
`komodo_update_permission_on_target`	특정 리소스 하나에 대한 사용자 또는 그룹의 권한 설정	full	destructive, idempotent

도구	설명	액세스	힌트
`komodo_write_resource`	모든 Komodo 리소스 생성, 업데이트 또는 삭제	full	destructive

작동 확인

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

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