Centreon MCP

集中MCP服务器

用于Centreon Web REST API v2。

作者: 0xEkho\ 许可证：MIT

特性

此MCP服务器通过REST API v2提供对Centreon监控基础设施的全面访问，包括：

• 认证：使用Centreon进行基于令牌的身份验证
• 主机管理：列出、创建、更新和删除主机
• 服务管理：管理服务及其配置
• 致谢：确认主机和服务问题
• 停机时间：安排和管理维护窗口
• 监控：实时监控状态和指标
• 配置：管理主机组、服务组、类别、严重性
• 资源：查询和筛选监控资源
• 命令：执行监控命令
• 时间段：管理监控时间表的时间段
• 联系人组：管理通知联系人和组
• 行政：平台配置和设置

安装

来源

git clone 
cd CENTREON-MCP
pip install -e .

来自PyPI

pip install centreon-mcp-server

配置

环境变量

创建一个 .env 文件或设置以下环境变量：

CENTREON_URL=https://your-centreon-server.com
CENTREON_USERNAME=your-username
CENTREON_PASSWORD=your-password

MCP设置配置

添加到您的MCP设置文件（例如。， mcp-settings.json):

{
  "mcpServers": {
    "centreon": {
      "command": "centreon-mcp-server",
      "env": {
        "CENTREON_URL": "https://your-centreon-server.com",
        "CENTREON_USERNAME": "your-username",
        "CENTREON_PASSWORD": "your-password"
      }
    }
  }
}

用法

运行服务器

centreon-mcp-server

可用工具

服务器公开了以下MCP工具：

认证

• login -验证并获取API令牌
• logout -使当前会话无效

主机

• list_hosts -列出所有具有筛选选项的主机
• get_host -获取特定主机的详细信息
• create_host -创建新主机
• update_host -更新主机配置
• delete_host -删除主机
• list_host_groups -列出主机组
• list_host_categories -列出主机类别
• list_host_severities -列出主机严重性
• list_host_templates -列出主机模板

服务

• list_services -列出所有具有过滤功能的服务
• get_service -获取服务详细信息
• create_service -创建新服务
• update_service -更新服务配置
• delete_service -删除服务
• deploy_host_services -基于主机模板部署服务
• list_service_groups -列出服务组
• list_service_categories -列出服务类别
• list_service_severities -列出服务严重程度

致谢

• acknowledge_host -确认主机问题
• acknowledge_service -确认服务问题
• list_host_acknowledgements -列出主机确认
• list_service_acknowledgements -列出服务确认

停机时间

• schedule_host_downtime -安排主机维护
• schedule_service_downtime -安排服务维护
• list_host_downtimes -列出活动主机停机时间
• list_service_downtimes -列出活动服务停机时间
• cancel_downtime -取消计划停机时间

监控

• get_resources -使用筛选器查询监控资源
• count_resources -统计资源匹配条件
• export_resources -将资源导出到CSV
• get_host_status -获取主机监控状态
• get_service_status -获取服务监控状态
• list_monitoring_servers -列出监控服务器

配置

• generate_config -生成监控配置
• reload_config -重新加载监控配置
• generate_and_reload_config -在一次操作中生成和重新加载
• list_commands -列出可用命令
• list_time_periods -列出时间段
• list_contact_groups -列出联系人组

元服务

• list_meta_services -列出元服务
• get_meta_service -获取元服务详细信息
• get_meta_service_metrics -获取元服务的指标

高级

• get_dashboard_metrics -获取仪表板性能指标
• get_top_metrics -按资源获取顶级指标
• list_media -列出媒体文件
• get_user_filters -获取用户定义的筛选器

Docker部署

使用Docker Compose

1. 克隆存储库：

git clone https://github.com/0xEkho/CENTREON-MCP.git
cd CENTREON-MCP/deploy

1. 创建 .env 模板中的文件：

cp .env.example .env
# Edit .env with your Centreon credentials

1. 构建和启动：

docker-compose up -d

1. 验证：

curl http://localhost:8084/healthz

Docker配置

服务器在端口上运行 8084 并暴露：

• /healthz -健康检查端点
• /tools -列出可用的MCP工具
• /tools/call -通过REST API执行MCP工具

示例REST API调用：

curl -X POST http://localhost:8084/tools/call \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "list_hosts",
    "arguments": {
      "limit": 10
    }
  }'

例子

看 示例 详细使用示例目录：

• 01_list_hosts.md -列出和筛选主机
• 02_知识_服务.md -确认服务问题
• 03_时间表_下载时间.md -安排维护窗口
• 04_get_resources.md -查询监控资源
• 还有更多。..

发展

设置开发环境

pip install -e ".[dev]"

运行测试

pytest

代码格式化

black src/
ruff check src/

API版本

此服务器实现了Centreon Web REST API v2。

有关API的完整文档，请参阅：

• API中心文件: https://docs-api.centreon.com/api/centreon-web/
• OpenAPI规范: docs/centeron-api.yaml
• 项目文件: docs/

文档

• README.md -主要文件（本文件）
• TOOLS.md -完整的MCP工具参考
• docs/ -API规范和技术文件
• 示例/ -使用示例
• 部署/ -Docker部署指南
• 贡献.md -贡献指南
• 更改日志.md -版本历史

许可证

MIT许可证-请参阅 许可证 详细信息文件

贡献

欢迎投稿！请看 贡献.md 了解详情。

作者

由...创建 0xEkho

支持

对于问题和疑问：

• GitHub问题：https://github.com/0xEkho/CENTREON-MCP/issues
• Centreon文件：https://docs.centreon.com/
• Centreon社区：https://thewatch.centreon.com/