Skip to main content

vibeMK - CheckMK monitoring via LLM - MCP Server

Project description

vibeMK 🚀

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! 🎉

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_chexma_vibemk-0.3.10.tar.gz (104.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_chexma_vibemk-0.3.10-py3-none-any.whl (111.9 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_chexma_vibemk-0.3.10.tar.gz.

File metadata

  • Download URL: iflow_mcp_chexma_vibemk-0.3.10.tar.gz
  • Upload date:
  • Size: 104.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_chexma_vibemk-0.3.10.tar.gz
Algorithm Hash digest
SHA256 1b4f7913692a8c9629e5b24518c82f78936a7755753eb65ce2c698618d6a542f
MD5 6b1a2dec5e4a687c3115e203cc6b2456
BLAKE2b-256 af60fcd307686ef6f85608abe500c292f1aa6bff1edc64b0cb13db225ee83a9d

See more details on using hashes here.

File details

Details for the file iflow_mcp_chexma_vibemk-0.3.10-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_chexma_vibemk-0.3.10-py3-none-any.whl
  • Upload date:
  • Size: 111.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_chexma_vibemk-0.3.10-py3-none-any.whl
Algorithm Hash digest
SHA256 fbecada78d6b3bd1dd759421cb3163091cca5686fb9cee2cb21795aa0b33fcb4
MD5 9b8ee97c37140a2c0f21a459d4757e37
BLAKE2b-256 55c878fbc31e464390b493bed02990c4449d14fb71dc590ffe4fb9b1f7852a5f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page