vibeMK

io.github.chexmav0.6.4Updated Oct 3, 2026

Query and configure CheckMK monitoring: hosts, services, rules, downtimes, metrics

VerifiedSTDIODesktop onlyCloud & InfrastructureSecurity & Monitoring

Overview

AI-generated overview

Lets an assistant read and change CheckMK monitoring through natural language: hosts, services, rules, downtimes, metrics and users.

What it does
vibeMK connects an assistant to a CheckMK monitoring site. It reads live host and service states, performance metrics and current problems, and it can schedule downtimes, acknowledge or remove acknowledgements, and create folders, rules, time periods, host groups, tags, user accounts and contact groups. It supports CheckMK 2.3.x through 2.5.x, with Raw, Enterprise and Cloud editions.
When to use it
Use it when you want to inspect or administer a CheckMK environment conversationally, for example to check what is currently down, compare metrics between hosts, schedule maintenance windows, or review and consolidate rulesets. A read-only mode is available if you only want analysis.
Requirements
Runs locally as a Python package (pipx, uv or pip) started by the MCP client over stdio. Requires a CheckMK server URL, site name and automation user, plus the automation secret in CHECKMK_PASSWORD; optional CHECKMK_VERIFY_SSL, NEVER_ACTIVATE_CHANGES and VIBEMK_READ_ONLY. The automation user needs administrator permissions for changes, or a read-only role for analysis. An optional HTTP mode needs a bearer token.
Before you install
The server can write to CheckMK: it creates and deletes folders, rules, users and downtimes and changes acknowledgements, and the README warns it is alpha software used at your own risk. The automation secret in CHECKMK_PASSWORD grants the account's rights, so use a read-only role or VIBEMK_READ_ONLY where possible. In HTTP mode the token is mandatory and the port inherits the CheckMK account's access.

Installation

In SourceWeft

  1. Open vibeMK in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

vibeMK 🚀

CheckMK Monitoring via LLM - Professional MCP Server

[Python 3.10+] [CheckMK 2.3+] [License: GPL v3] [MCP Compatible] [MCP SDK] [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

bash
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 Client4. 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. Upgrading from 0.3.x or older: git pull is not enough, see Upgrading. More Examples: See examples/llm_configs/ and INSTALL.md
Visual Examples: See examples/Screenshots/ for example prompts and usage patterns

🔌 Running it

Locally (default). The LLM client starts vibeMK itself over stdio. Nothing to host, nothing to secure -- the client already owns the process.

Centrally. One instance can serve many clients over Streamable HTTP, so they need neither Python nor vibeMK installed:

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

Clients connect to http://<host>:8765/mcp and send Authorization: Bearer <token>. The token is mandatory, and vibeMK binds to localhost unless told otherwise: the CheckMK account lives on the server, so whoever reaches the port inherits it. See INSTALL.md for what that means before you expose it.

💡 Practical Prompt Examples

bash
# 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 VersionCompatibilityFeatures
2.5.x✅ FullAll features available, tested against 2.5.0p14 (Raw and Ultimate)
2.4.x✅ FullAll features available
2.3.x✅ FullAll features available
2.2.x and older🔴 Unsupported

Checkmk Edition Support

  • Raw Edition: Fully supported, including the BI and Event Console endpoints
  • Enterprise Edition: Adds the Agent Bakery and custom graphs
  • Cloud Edition: All Enterprise features

Edition availability follows the operationId of each endpoint in the Checkmk OpenAPI document: cmk.gui.cee.* is Enterprise-only, everything else is served by every edition including Raw.

Security considerations

  • To let a model look without touching, start vibeMK read-only: --read-only or VIBEMK_READ_ONLY=1. Only the tools that read are offered, and a call to any other is refused before it reaches CheckMK
  • 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! 🎉

Source: README.md at commit e1cc869

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.6.4LatestOct 3, 2026