clr-openmanage-mcp
  
用于Dell OpenManage Enterprise(OME)的MCP服务器——通过Claude等人工智能助手监控和管理Dell服务器。
特性
- 设备管理 --列出设备、查看详细信息、运行状况摘要
- 警报管理 --列表、筛选、确认警报(单个或批量)
- 保修跟踪 --列出保修单,查找过期保修单
- 固件合规性 --检查固件基线
- 作业监视 --查看OME作业及其状态
- 集团和政策管理 --列出设备组和警报策略
- OData分页 --自动多页结果提取
- 基于会话的身份验证 --安全的X-Auth-Token会话,自动创建和清理
安装
pip install clr-openmanage-mcp
# or
uvx clr-openmanage-mcp配置
首选: 配置文件位于 ~/.config/openmanage/credentials.json (克莫德600):
{
"host": "ome.example.com",
"username": "admin",
"password": "your-password"
}备选方案: 还支持环境变量:
| 变量 | 描述 | 示例 |
|---|---|---|
OME_HOST | OME服务器主机名或IP | ome.example.com |
OME_USERNAME | OME管理员用户名 | admin |
OME_PASSWORD | OME管理员密码 | secretpass |
可选:
| 变量 | 描述 | 默认值 |
|---|---|---|
OME_READ_ONLY | 以只读模式运行 | false |
OME_TRANSPORT | 传输协议(stdio 或 http) | stdio |
OME_LOG_LEVEL | 日志级别 | INFO |
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"openmanage": {
"command": "uvx",
"args": ["clr-openmanage-mcp"]
}
}
}克劳德代码
通过CLI添加:
claude mcp add openmanage -- uvx clr-openmanage-mcp或添加到您的 .mcp.json:
{
"openmanage": {
"command": "uvx",
"args": ["clr-openmanage-mcp"]
}
}VS代码
添加到您的VS代码设置或 .vscode/mcp.json:
{
"mcp": {
"servers": {
"openmanage": {
"command": "uvx",
"args": ["clr-openmanage-mcp"]
}
}
}
}注: 从读取配置 ~/.config/openmanage/credentials.json 或环境变量。无需在MCP配置文件中指定凭据。
HTTP传输
要作为独立的HTTP服务器运行,请执行以下操作:
clr-openmanage-mcp --transport http --host 0.0.0.0 --port 8000工具
系统
| 工具 | 说明 |
|---|---|
ome_version | 获取OME版本、构建信息和操作状态 |
设备
| 工具 | 说明 | 参数 |
|---|---|---|
ome_list_devices | 列出所有受管设备 | top? |
ome_get_device | 获取单个设备的完整细节 | device_id |
ome_device_health | 聚合设备运行状况摘要(按状态计数) | -- |
警报
| 工具 | 说明 | 参数 |
|---|---|---|
ome_list_alerts | 使用可选筛选器列出警报 | severity?, category?, status?, top? |
ome_get_alert | 获取单个警报的完整细节 | alert_id |
ome_alert_count | 按严重性汇总的警报计数 | -- |
ome_alert_ack | 按ID确认一个或多个警报 | alert_ids |
ome_alert_ack_all | 确认所有与筛选器匹配的未确认警报 | severity?, category? |
警报筛选器值:
| 参数 | 接受值 |
|---|---|
severity | critical, warning, info, normal |
status | unack, ack |
category | 例如。 Warranty, System Health |
保修
| 工具 | 说明 | 参数 |
|---|---|---|
ome_list_warranties | 列出所有保修记录 | top? |
ome_warranties_expired | 列出过期保修 | -- |
组、作业、策略和固件
| 工具 | 说明 | 参数 |
|---|---|---|
ome_list_groups | 列出设备组 | top? |
ome_list_jobs | 列出作业(按最近的作业排序) | top? |
ome_list_policies | 列出警报策略 | top? |
ome_list_firmware | 列出固件合规性基线 | top? |
示例用法
连接后,您可以向您的AI助手询问以下问题:
- “显示OpenManage中的所有设备”
- “是否有任何关键警报?”
- “哪些服务器保修已过期?”
- “确认所有保修警报”
- “显示最近的工作”
- “固件符合性状态如何?”
安全
所有工具都是 只读 除了 ome_alert_ack 和 ome_alert_ack_all,这是非破坏性的写入操作——它们将警报标记为已确认,但不会修改设备配置。
技术说明
- SSL: 自签名证书验证已禁用(OME设备常见)
- 认证: 基于X-Auth-Token的会话,启动时自动创建,关闭时清理
- 分页: 自动跟随OData
@odata.nextLink获取所有页面(除非top已设置) - 工作API: OME Jobs API不支持
$orderby,因此结果在客户端按以下方式排序LastRun - 保修日期: OME不支持OData中的日期比较
$filter对于保修端点,因此过期保修过滤是在客户端完成的
发展
git clone https://github.com/clearminds/clr-openmanage-mcp.git
cd clr-openmanage-mcp
uv sync
uv run clr-openmanage-mcp许可证
麻省理工学院——见 许可证 了解详情。
