CheckMK Monitoring via LLM - Professional MCP Server

Python 3.8+ CheckMK 2.1+ License: GPL v3 MCP Compatible No Dependencies Code style: black Typed

🎯 Overview

vibeMK enables complete management of your CheckMK monitoring environment directly through LLM interfaces using natural language. This project is in the alpha stage and under development. I accept no liability for any damage resulting from the use of this software.

vibeMK - Current Features

Live Monitoring ✅

• Host Status: Real-time host state (UP/DOWN/UNREACHABLE) with hard state detection
• Service Status: Live service monitoring (OK/WARNING/CRITICAL/UNKNOWN)
• Performance Metrics: Retrieve metrics data with automatic discovery
• Current Problems: Auto-detect all active monitoring issues

Downtime Management ✅

• Schedule Downtimes: Create host/service downtimes with flexible duration parsing ("2h", "1h30m")
• List & Filter: View all downtimes or filter for active ones only

Problem Management ✅

• Acknowledge Problems: Set acknowledgements for host/service issues (sticky/persistent options)
• List Acknowledgements: View all current problem acknowledgements
• Remove Acknowledgements: Delete by pattern or individual removal

Configuration Management ✅

• Folders: Create/delete monitoring folder structures
• Rules: Create rules for 2000+ CheckMK ruleset types with proper format handling
• Time Periods: Create custom notification schedules (business hours, 24/7, etc.)
• Host Groups: Organize hosts into logical groups

User & Security ✅

• User Accounts: Create/manage user accounts with role assignment
• Password Management: Set passwords with policy enforcement
• Contact Groups: Manage notification groups
• Host/Service Tags: Comprehensive tagging system

🚀 Quick Start

1. git clone https://github.com/chexma/vibeMK.git
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

Complete Installation Guide: See INSTALL.md for detailed step-by-step instructions. More Examples: See examples/llm_configs/ and INSTALL.md
Visual Examples: See examples/Screenshots/ for example prompts and usage patterns

💡 Practical Prompt Examples

# 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."

Advanced Usage: See examples/ExamplePrompts.md for complex scenarios and tips

📚 Checkmk version compatibility

CheckMK Version	Compatibility	Features
2.4.x	✅ Full	All features available
2.3.x	✅ Full	All features available
2.2.x	⚠️ Untested
2.1.x	⚠️ Untested
2.0.x	⚠️ Untested
1.6.x	🔴 Unsupported

Checkmk Edition Support

• Raw Edition: Basic functions available
• Enterprise Edition: All features including BI, Agent Bakery, Metrics
• Cloud Edition: All Enterprise features

Security considerations

• Be aware of the potential security risks when you unleash AI on your checkmk
• Use at your own risk
• I accept no responsibility for actions performed by an AI

📄 License

This project is licensed under the GNU General Public License v3.0.

---

Happy Monitoring with CheckMK and LLMs! 🎉