vibeMK

vibeMK 🚀

LLM による CheckMK 監視 — プロフェッショナル向け MCP サーバー

🎯 概要

vibeMK を使うと、自然言語で LLM インターフェースから CheckMK の監視環境を直接、包括的に管理できます。 このプロジェクトはアルファ段階で、開発中です。このソフトウェアの使用によって生じたいかなる損害についても、責任を負いません。

vibeMK — 現在の機能

ライブ監視 ✅

• ホストの状態：確定状態の検出を含む、ホストのリアルタイム状態（UP/DOWN/UNREACHABLE）
• サービスの状態：サービスのライブ監視（OK/WARNING/CRITICAL/UNKNOWN）
• パフォーマンス指標：自動検出による指標データの取得
• 現在の問題：すべてのアクティブな監視問題を自動検出

ダウンタイム管理 ✅

• ダウンタイムのスケジュール設定：期間を柔軟に指定（「2h」、「1h30m」）して、ホスト／サービスのダウンタイムを作成
• 一覧表示とフィルター：すべてのダウンタイムを表示するか、アクティブなものだけに絞り込み

問題管理 ✅

• 問題の確認：ホスト／サービスの問題に確認を設定（固定／永続オプション）
• 確認の一覧表示：現在の問題確認をすべて表示
• 確認の削除：パターンを指定して削除、または個別に削除

構成管理 ✅

• フォルダー：監視用フォルダー構造を作成／削除
• ルール：2000 種類以上の CheckMK ルールセットタイプに対応した形式処理でルールを作成
• 時間帯：カスタム通知スケジュール（営業時間、24 時間 365 日など）を作成
• ホストグループ：ホストを論理グループに整理

ユーザーとセキュリティ ✅

• ユーザーアカウント：ロールを割り当ててユーザーアカウントを作成／管理
• パスワード管理：ポリシーを適用してパスワードを設定
• コンタクトグループ：通知グループを管理
• ホスト／サービスタグ：包括的なタグ付けシステム

🚀 クイックスタート

1. pipx install vibemk   (or: uv tool install vibemk, or pip install vibemk into a virtual environment)
2. Edit the configuration file of your LLM Client, e.g. Claude Desktop - claude_desktop_config.json (See examples)
3. Start your LLM Client
4. CheckMK automation user setup (Administrator permissions or a customized role if changes are to be made, read-only if only analyses are to be performed.)
5. voila - configure checkmk using natural language

インストールガイド全文：手順ごとの詳細な説明は INSTALL.md を参照してください。 0.3.x 以前からアップグレードする場合：git pull だけでは不十分です。アップグレードを参照してください。 その他の例：examples/llm_configs/ と INSTALL.md を参照してください。
視覚的な例：プロンプトと使用パターンの例は examples/Screenshots/ を参照してください。

🔌 実行方法

ローカル（デフォルト）。 LLM クライアントが stdio 経由で vibeMK 自体を起動します。ホストする必要も、 セキュリティ対策を講じる必要もありません。プロセスはクライアントが所有します。

一元管理。 1 つのインスタンスで Streamable HTTP 経由の多数のクライアントに対応できるため、 クライアント側に Python や vibeMK をインストールする必要はありません。

export VIBEMK_HTTP_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"
vibemk --transport http --port 8765

クライアントは http://<host>:8765/mcp に接続し、Authorization: Bearer <token> を送信します。 トークンは必須です。また、別途指定しない限り、vibeMK は localhost にバインドされます。 CheckMK アカウントはサーバー上にあるため、ポートにアクセスできる人は誰でもそのアカウントを利用できます。 外部に公開する前に、どのような影響があるか INSTALL.md を参照してください。

💡 実用的なプロンプト例

# Add new server
"Create a new host 'web-server-05' in folder 'Servers' with IP 192.168.1.105 and discover all services"

# Schedule maintenance
"Schedule a 2-hour downtime for the service Check_MK on 'cephnode01' starting at 22:00 tomorrow for 'Debian Updates'"

# Downtimes 
"show me all current scheduled downtimes."

# Metric analysis
"Compare the “response_time” metric of the “HTTPS Webservice” service of the two hosts www.google.de and www.heise.de for the last ten minutes."

# Ruleset analysis
"analyze and compare the rulesets "Filesystems (used space and growth)" and see, if there are duplicates or if rules can be combined."

高度な使い方：複雑なシナリオやヒントについては examples/ExamplePrompts.md を参照してください

📚 Checkmk バージョンの互換性

CheckMK バージョン	互換性	機能
2.5.x	✅ 完全対応	すべての機能を利用できます。2.5.0p14（Raw および Ultimate）に対してテスト済みです
2.4.x	✅ 完全対応	すべての機能を利用できます
2.3.x	✅ 完全対応	すべての機能を利用できます
2.2.x 以前	🔴 非対応

Checkmk エディションのサポート

• Raw Edition：BI および Event Console のエンドポイントを含め、完全にサポートされています
• Enterprise Edition：Agent Bakery とカスタムグラフが追加されます
• Cloud Edition：Enterprise のすべての機能を利用できます

エディションの利用可否は、Checkmk の OpenAPI ドキュメントに記載された各エンドポイントの operationId に従います。cmk.gui.cee.* は Enterprise 専用で、それ以外は Raw を含むすべてのエディションで利用できます。

セキュリティに関する考慮事項

• モデルに変更を加えずに確認だけさせるには、vibeMK を読み取り専用で起動してください：--read-only または VIBEMK_READ_ONLY=1。読み取り専用のツールのみが提供され、それ以外のツールへの呼び出しは CheckMK に到達する前に拒否されます
• checkmk で AI を利用する際の潜在的なセキュリティリスクに注意してください
• ご自身の責任でご利用ください
• AI が実行した操作について、私は一切責任を負いません

📄 ライセンス

このプロジェクトは GNU General Public License v3.0 の下でライセンスされています。

---

CheckMK と LLM で、快適な監視を！ 🎉