MCP Komodo

](https://www.npmjs.com/package/@samik081/mcp-komodo) ](https://ghcr.io/samik081/mcp-komodo)  ](https://nodejs.org)

MCP科莫多

MCP服务器 科莫多 DevOps平台。通过Cursor、Claude Code和Claude Desktop中的自然语言管理服务器、堆栈、部署、构建等。

特性

• 53工具 穿过 13个类别 涵盖完整的Komodo DevOps API
• 三个访问层 (read-only, read-execute, full)用于粒度控制
• 类别筛选 通过 KOMODO_CATEGORIES 仅公开您需要的工具
• 零HTTP依赖 --使用官方 komodo_client 软件开发工具包
• Docker镜像 为了 linux/amd64 和 linux/arm64 上 GHCR
• 远程MCP 通过HTTP传输(MCP_TRANSPORT=http)使用流式HTTP协议
• Types/ESM 具有全类型安全性

API兼容性

专为科莫多打造 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运行（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命令行界面（推荐）：

# 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_config.json，光标 .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（标准操作系统）：

{
  "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 环境变量：

层级详细信息：

• 满的：全部53个工具。包含 komodo_write_resource 用于创建、更新和删除Komodo资源。
• 读取执行：52个工具。所有读取工具加上执行工具（部署、拉取、生命周期、运行等）。这 komodo_write_resource 工具被隐藏。
• 只读：36个工具。仅列出、获取、记录、检查、统计、摘要和操作历史。所有执行和写入工具都是隐藏的。

您层中不可用的工具未在MCP服务器上注册。它们不会出现在你的人工智能工具的工具列表中，保持上下文干净。

集 KOMODO_ACCESS_TIER 到 read-only, read-execute，或 full （默认值： full).

环境变量

在下面的Komodo UI中生成API密钥 设置>API密钥.

可用类别

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

工具

mcp-komodo提供了53个按类别组织的工具。每个工具的“访问”列显示了所需的最低级别： read-only （适用于所有级别）， read-execute （要求 read-execute 或 full)，或 full （要求 full 仅限级别）。提示列显示工具行为： read-only （无状态变化）， destructive （修改现有状态）， idempotent （如果调用两次，结果相同）。

Servers (10 tools)

Stacks (10 tools)

Deployments (9 tools)

Containers (1 tool)

Builds (4 tools)

Repos (3 tools)

Procedures (3 tools)

Actions (3 tools)

Builders (2 tools)

Alerters (2 tools)

Resource Syncs (3 tools)

Updates (2 tools)

Write (1 tool)

验证它是否有效

配置完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中创建新的部署资源。

故障排除

连接被拒绝

检查一下 KOMODO_URL 正确，并且可以从运行MCP服务器的位置访问Komodo Core。服务器在启动时验证连接，因此如果连接成功启动，则URL在当时是有效的。

无效凭据/401未经授权

验证您的API密钥和机密是否正确。在Komodo UI的“设置”>“API密钥”下检查密钥是否未被吊销或过期。

工具未显示

检查您的访问层设置。在 read-only 模式下，仅注册了36个工具。在 read-execute 模式下，注册了52个工具。使用 full （或省略 KOMODO_ACCESS_TIER)适用于所有53种工具。检查 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

许可证

麻省理工学院