用途
openITCOCKPIT MCP Server 是一个 MCP 服务器，作用是在 openITCOCKPIT 监控实例与 LLM 客户端之间建立通道。它让语言模型能够回答“什么坏了、为什么坏、谁已经在处理、有什么变化”这类问题；在启用写入工具后，还可以对监控配置执行操作。
主要能力
- 提供 42 个工具：20 个只读工具，22 个会改变状态的工具。
- 读取内容涵盖主机与服务状态、检查历史、日志、停机（downtimes）、确认（acknowledgements）、软件清单以及待处理的安全更新。
- 写入工具默认关闭，未启用前不会注册，因此默认情况下无法调用。
- 工具使用名称而非 ID：接收主机名、模板名和容器路径，由服务器自行解析。
- 写入操作带有范围校验：在发送任何内容之前，会针对目标容器校验引用，这一点是 openITCOCKPIT 自身 API 所不具备的。
使用方式
- 将客户端指向
http://localhost:8000/mcp，并使用.env中的 bearer token。 - Compose 读取同一文件来获取发布端口，因此在其中设置
OITC_PORT会同时移动两端。 - 启动时有三个关键设置：
MCP_AUTH_TOKEN（客户端向本服务器出示的令牌）、OITC_BASEURL和OITC_APIKEY（本服务器向 openITCOCKPIT 出示的凭据）。其余所有设置均有默认值。 - 需要 openITCOCKPIT 5.6 或更高版本。
工具集（toolsets）与限制方式
运行一个监控实例不是单一任务，因此服务器保留每个工作所需的全部工具，再通过 toolset 把其中一份交给某个 agent：大约十个工具，对该任务而言完整且不多余。从未注册的工具完全无法调用。 官方随附的工具集包括：health、operations、lifecycle、patch、reporting、catalog、onboarding、config 和 provisioning。工具集定义在可替换的文件中（docs/toolsets.md）。
评测
oitc-mcp-eval 会针对你的实例提出运维者问题，检查模型是否基于工具作答而非编造。每次运行结果保存在 SQLite 中，便于比较不同模型和改动。
安全说明
服务器持有一个 openITCOCKPIT 凭据，且永不将其发送给客户端。客户端使用自己的令牌认证；在委托模式下，每个请求携带一个短期用户令牌，服务器以该用户身份及其权限行事。写入工具在启用前保持未注册状态。
限制与风险
- 官方明确提示“使用风险自负”：该服务器允许语言模型读取，并在启用写入工具后修改监控配置。
- 模型可能误解请求或选错调用，应在批准前审核其提出的操作，并从只读访问开始。
- 软件按“原样”提供，不附带任何形式的保证或责任（MIT 许可证）。
- 关于各工具的名称、参数及上下文开销，可参考 docs/tools.md（由代码生成）；结果形态与写入行为见 docs/using-the-tools.md。
