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 規範
• 示例與集成 - 即用型配置