JinDaGe - komodo-mcp-server MCP Details

article

README

🚀 蜥蜴龙（Komodo）MCP 服务器

适用于蜥蜴龙（Komodo）的模型上下文协议服务器

通过蜥蜴龙（Komodo）结合人工智能助手和自动化工具来管理你的 Docker 或 Podman 部署。

蜥蜴龙（Komodo）MCP 服务器能够实现人工智能助手（如 Claude、GitHub Copilot）与蜥蜴龙（Komodo，容器管理平台）之间的无缝交互，从而高效地进行容器管理、服务器编排和部署操作。MCP 服务器让你能够使用自然语言或自动化工作流程来控制由蜥蜴龙（Komodo）管理的基础设施。

主要特性 • 快速开始 • 使用示例 • 详细文档

✨ 主要特性

| 特性分类 | 详情 | | ---- | ---- | | 🐳 容器管理 | - 启动、停止、重启容器
- 暂停和恢复操作
- 列出并监控容器
- 跨服务器管理 | | 📦 部署与堆栈 | - 部署容器及更新
- 管理 Docker Compose 堆栈
- 多环境部署
- 堆栈生命周期控制 | | 🖥️ 服务器操作 | - 列出所有受管理的服务器
- 获取服务器统计信息
- 健康监控
- 资源跟踪 | | 🤖 MCP 集成 | - 可与任何 MCP 客户端配合使用
- 支持 Claude Desktop
- 支持 VS Code Copilot
- 与 n8n 自动化兼容
- 双传输模式（标准输入输出 + HTTP/SSE） | | ⚡ 性能 | - 预编译正则表达式
- 工具注册表缓存
- O(1) 循环缓冲区历史记录
- 支持请求取消 | | 🔒 安全与可靠性 | - DNS 重绑定保护
- 速率限制（可配置）
- CORS 源验证
- 优雅关机处理 |

🚀 快速开始

选项 1：Docker（推荐）

# 拉取镜像
docker pull ghcr.io/mp-tool/komodo-mcp-server:latest

# 使用 Docker Compose 运行
cd examples/compose
cp .env.example .env
# 使用你的蜥蜴龙（Komodo）凭证编辑 .env
docker compose up -d

选项 2：Claude Desktop

# 复制配置
cp examples/claude/claude_desktop_config.json \
   ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 编辑凭证并重启 Claude

额外配置与集成指南

VS Code Copilot Chat

只需将提供的 mcp.json 复制到你的 VSCode 工作区

cp examples/vscode/mcp.json .vscode/

📚 完整设置指南：请参阅 examples/ 获取详细说明

💻 使用示例

基础用法

使用 MCP 检查工具进行测试

你可以使用 MCP 检查工具进行测试。

注意：使用 http://<IP/域名>:<端口>/mcp 进行可流式 HTTP 传输，或使用 http://<IP/域名>:<端口>/sse 进行 SSE 传输（如果已启用）。如果两种传输方式都已启用，服务器将优先使用可流式 HTTP，但 /mcp 端点也支持 SSE。请根据你的配置修改 IP/域名和端口。

npx @modelcontextprotocol/inspector --url http://localhost:3000/mcp

高级用法

💬 与人工智能助手配合使用

向 Claude、Copilot 或任何兼容 MCP 的助手提问：

"列出我所有的蜥蜴龙（Komodo）服务器"
"显示生产服务器上的容器"
"启动 nginx 容器"
"将 my-app 部署到预发布环境"
"获取开发服务器的统计信息"

🔄 与 n8n 自动化配合使用

即将推出：用于自动容器健康检查和部署管道的预构建 n8n 工作流。

📚 详细文档

要求

蜥蜴龙（Komodo） v1.19.5 或更高版本
Docker（用于容器化部署）
Node.js 20+（用于本地开发）
有效的蜥蜴龙（Komodo）凭证（API 密钥/密钥或用户名/密码）

集成指南

Docker Compose - 独立部署
VS Code - 支持 GitHub Copilot Chat
Claude Desktop - 直接 MCP 集成

📄 许可证

本项目采用 GPL - 3.0 许可证，详情请参阅 LICENSE。

贡献

欢迎贡献代码！详情请参阅我们的贡献指南。

开发

# 克隆并安装
git clone https://github.com/MP-Tool/komodo-mcp-server.git
cd komodo-mcp-server
npm install

# 构建并运行
npm run build
npm start

安全

通过 GitHub 的私有漏洞报告功能报告安全漏洞（请参阅 SECURITY.md）。

最佳实践：

切勿提交凭证
使用环境变量
保持依赖项更新
以非根用户身份运行（Docker 中为默认设置）

链接

蜥蜴龙（Komodo）GitHub - 容器编排平台
蜥蜴龙（Komodo）文档 - 蜥蜴龙（Komodo）文档
模型上下文协议 - MCP 规范
示例与集成 - 即用型配置

为蜥蜴龙（Komodo）社区用心打造 🦎 报告漏洞 • 请求新特性 • 讨论

komodo-mcp-server