vibeMK

vibeMK 🚀

通过大模型监控 CheckMK - 专业 MCP 服务

🎯 概述

vibeMK 让你可以直接通过自然语言与大模型接口交互，全面管理 CheckMK 监控环境。 本项目目前处于 Alpha 阶段，仍在开发中。对于使用本软件造成的任何损失，我不承担责任。

vibeMK - 当前功能

实时监控 ✅

• 主机状态：实时主机状态（UP/DOWN/UNREACHABLE），并检测硬状态
• 服务状态：实时监控服务（OK/WARNING/CRITICAL/UNKNOWN）
• 性能指标：自动发现并获取指标数据
• 当前问题：自动检测所有正在发生的监控问题

停机管理 ✅

• 安排停机时间：创建主机/服务停机时间，支持灵活的时长解析（“2h”“1h30m”）
• 列表与筛选：查看所有停机时间，或仅筛选活动中的停机时间

问题管理 ✅

• 确认问题：为主机/服务问题设置确认（可选固定/持久化）
• 查看确认记录：查看当前所有问题确认记录
• 移除确认记录：按模式删除或逐条移除

配置管理 ✅

• 文件夹：创建/删除监控文件夹结构
• 规则：为 2000 多种 CheckMK 规则集类型创建规则，并正确处理格式
• 时间段：创建自定义通知计划（工作时间、全天候等）
• 主机组：将主机组织到逻辑分组中

用户与安全 ✅

• 用户账户：创建/管理用户账户并分配角色
• 密码管理：设置密码并强制执行密码策略
• 联系人组：管理通知组
• 主机/服务标签：全面的标签系统

🚀 快速开始

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/，查看示例提示词和使用模式

🔌 运行方式

本地（默认）。 大模型客户端通过 stdio 启动 vibeMK。无需托管，也无需额外保护——客户端本身已拥有该进程。

集中式。 一个实例可以通过 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 版本：完全支持，包括 BI 和 Event Console 端点
• Enterprise 版本：增加 Agent Bakery 和自定义图表
• Cloud 版本：包含所有 Enterprise 功能

版本可用性依据 Checkmk OpenAPI 文档中各端点的 operationId：cmk.gui.cee.* 仅限 Enterprise 版本，其他端点则由包括 Raw 在内的所有版本提供。

安全注意事项

• 若要让模型只查看、不进行修改，请以只读模式启动 vibeMK：--read-only 或设置 VIBEMK_READ_ONLY=1。系统只会提供读取类工具，任何其他调用都会在到达 CheckMK 之前被拒绝
• 请注意让 AI 访问你的 checkmk 可能带来的安全风险
• 使用风险自负
• 对 AI 执行的操作，本人概不负责

📄 许可证

本项目基于 GNU General Public License v3.0 授权。

---

祝你使用 CheckMK 和大模型监控愉快！ 🎉