Komodo MCP Server

🚀 🦎 Komodo MCP Server

Komodo MCP Serverは、AIアシスタントや自動化ツールを通じて、Komodoを用いたDockerまたはPodmanのデプロイメントを管理するためのサーバーです。AIアシスタント（ClaudeやGitHub Copilotなど）とKomodo（コンテナ管理プラットフォーム）の間でシームレスなやり取りを可能にし、効率的なコンテナ管理、サーバーオーケストレーション、およびデプロイメント操作を実現します。MCP-Serverを使用すると、自然言語または自動化ワークフローを使ってKomodoで管理されるインフラストラクチャを制御することができます。

主な機能 • クイックスタート • 使用例 • ドキュメント

✨ 主な機能

🚀 クイックスタート

オプション1: Docker（推奨）

# イメージを取得
docker pull ghcr.io/mp-tool/komodo-mcp-server:latest

# Docker Composeで実行
cd examples/compose
cp .env.example .env
# .envをKomodoの資格情報で編集
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インスペクターツールを使って試してみてください。

注意: Streamable HTTPトランスポートにはhttp://<IP/DOMAIN>:<PORT>/mcpを、SSEトランスポート（有効になっている場合）にはhttp://<IP/DOMAIN>:<PORT>/sseを使用してください。両方のトランスポートが有効になっている場合、サーバーはStreamable HTTPを優先しますが、/mcpエンドポイントでSSEも利用可能です。IP/ドメインとポートをあなたの設定に合わせて修正してください。

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

💬 AIアシスタントとのやり取り

Claude、Copilot、またはMCP互換のアシスタントに以下のような質問をしてください。

"List all my Komodo servers"
"Show containers on production-server"  
"Start the nginx container"
"Deploy my-app to staging"
"Get stats for dev-server"

🔄 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のPrivate Vulnerability Reportingを通じて報告してください（SECURITY.mdを参照）。

ベストプラクティス:

• 資格情報をコミットしないでください。
• 環境変数を使用してください。
• 依存関係を最新の状態に保ってください。
• 非ルートユーザーとして実行してください（Dockerではデフォルト）。

リンク

• Komodo GitHub - コンテナオーケストレーションプラットフォーム
• Komodo Docs - Komodoのドキュメント
• Model Context Protocol - MCP仕様
• Examples & Integrations - すぐに使える設定