Komodo MCP Server

🚀 蜥蜴龙（Komodo）MCP 服务器

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

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

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

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

✨ 主要特性

🚀 快速开始

选项 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/

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

💻 使用示例

基础用法

使用 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 规范
• 示例与集成 - 即用型配置