Icinga MCP 服务器

mcp-server-icinga 是一个模型上下文协议 (MCP) 服务器，允许 Claude 等 AI 客户端通过自然语言与 Icinga 安装进行交互。它面向在生产环境中运行 Icinga 并希望在现有 Icinga REST API 之上获得用于日常分类、事件调查和常规操作的聊天驱动界面的 Linux 系统工程师。

本项目是在 Anthropic 的 Claude Code 协助下开发的。

范围

该服务器连接了三个 Icinga 界面和 Linuxfabrik 监控堆栈：

• Icinga 2 Core REST API (端口 5665)：实时主机和服务对象、按需检查、确认、停机时间。

• Icinga Web 2 / Icinga DB Web 模块：更丰富的状态投影、历史记录、评论、通知，受限于 Icinga Web 界面。

• Icinga Director API：对象浏览、服务模板内省、命令目录。

• Linuxfabrik monitoring-plugins 目录：每个检查插件的实现、输入、输出、状态和性能数据，以便服务器不仅能说明服务正在报警，还能解释原因。

• 时间序列数据库 (默认：InfluxDB，模块化)：用于趋势分析、抖动分析和根本原因调查的历史性能数据。

每个后端都位于其自己的模块中，以便操作员只需连接他们实际运行的部分。服务器会透明地标记底层 API 未公开的信息，而不是进行猜测。

Related MCP server: PilotOps MCP

状态

早期开发阶段。架构、配置和工具界面不稳定，将会发生变化。

要求

• Python 3.14 或更高版本。

• 可访问的 Icinga 安装（以下一项或多项：Icinga 2 Core API、带有 Icinga DB Web 模块的 Icinga Web 2、Icinga Director）。

• 可选：用于历史性能数据的时间序列数据库后端。默认集成为 InfluxDB；TSDB 层是模块化的，因此可以插入其他后端。

安装

安装说明将在发布第一个版本后记录。

配置

配置文档将在配置界面稳定后发布。

相关项目

• Linuxfabrik monitoring-plugins：此服务器所理解的检查插件目录。

• Linuxfabrik lib：共享 Python 辅助工具。

• Icinga/icinga-mcp：由 Icinga 团队提供的上游概念验证 MCP 服务器。范围不同，架构也不同。

许可证

根据 Unlicense 发布到公共领域。