Skip to content

vibeMK v0.1.0 - First Official Release 🎉

Choose a tag to compare

View all tags
@chexma chexma released this 20 Aug 21:10
· 39 commits to main since this release
v0.1.0
5bc656a

🎉 vibeMK v0.1.0 - First Official Release

CheckMK Monitoring via LLM - Professional MCP Server

✨ What's New

This is the first stable release of vibeMK, providing complete CheckMK monitoring integration for any LLM client via the Model Context Protocol (MCP).

🏗️ Core Features

  • 82 unified tools with vibemk_ prefix for better namespace management
  • Zero dependencies - uses only Python standard library
  • LLM platform independent - works with Claude Desktop, OpenAI clients, and any MCP-compatible LLM
  • Modular architecture with clean separation of concerns
  • Live monitoring data with accurate host and service states

🔧 Major Capabilities

Host & Service Management

  • ✅ Create, configure, move, and delete hosts
  • ✅ Service discovery and status monitoring
  • ✅ Real-time monitoring with hard/soft state differentiation

Problem & Configuration Management

  • ✅ View current problems and acknowledge issues
  • ✅ Schedule maintenance downtimes
  • ✅ Activate configuration changes
  • ✅ Manage folders, groups, and organizational structure

Advanced Features

  • ✅ Rule management for monitoring configuration
  • ✅ User and contact group management
  • ✅ Comprehensive debugging and diagnostics
  • ✅ Support for all CheckMK editions (CE/EE/CCE/CRE)

🎯 Critical Fixes in v0.1.0

Host Status Accuracy Fix

  • Issue: DOWN hosts incorrectly showed as UP
  • Solution: Now uses hard_state when state_type=1 for accurate monitoring
  • Result: Proper state mapping (0=UP, 1=DOWN, 2=UNREACHABLE)

Service Status Enhancement

  • Issue: Service status showing "unknown" instead of actual state
  • Solution: Uses CheckMK show_service action with live monitoring data
  • Result: Accurate service states (0=OK, 1=WARNING, 2=CRITICAL, 3=UNKNOWN)

API Integration Fixes

  • Folders: Fixed HTTP 400 errors with correct API data format
  • Rules: Fixed rule creation with Python string literals
  • Retrieval: Fixed rule queries to show actual rules instead of metadata

🌍 International & Platform Independence

  • Complete English documentation (translated from mixed German/English)
  • LLM platform agnostic terminology throughout
  • Comprehensive guides: Installation, troubleshooting, examples
  • Professional documentation standards established

📊 Compatibility

Component Requirement Status
CheckMK 2.0+ (REST API) ✅ Full Support
CheckMK 1.6+ (Web API) ⚠️ Limited Support
Python 3.8+ ✅ Required
LLM Client MCP Protocol ✅ Any Compatible Client

🚀 Getting Started

  1. Clone repository:

    git clone https://github.com/chexma/vibeMK.git
cd vibeMK

  2. Configure LLM client (see INSTALL.md for details):

    {
  "mcpServers": {
    "vibemk": {
      "command": "python",
      "args": ["/path/to/vibemk/main.py"],
      "env": {
        "CHECKMK_SERVER_URL": "https://your-checkmk-server",
        "CHECKMK_SITE": "your-site",
        "CHECKMK_USERNAME": "automation",
        "CHECKMK_PASSWORD": "your-api-key"
      }
    }
  }
}

  3. Test connection:

    Ask your LLM: "Use vibemk_debug_checkmk_connection to test the connection"

📚 Documentation

  • 📖 Installation Guide - Complete setup instructions
  • 📚 README - Features overview and examples
  • 🔧 CLAUDE.md - Technical development notes
  • 💡 Examples - Configuration examples for different setups

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📞 Support

🎯 What's Next

This release establishes a solid foundation for CheckMK monitoring via LLM. Future releases will focus on:

  • Additional enterprise features
  • Performance optimizations
  • Extended CheckMK integration
  • Community-requested features

Ready for production use! 🚀

Manage your complete CheckMK environment using natural language with any LLM client.

Assets 2
Loading