← 返回目录

CLIO Node Hardware

社区

全面的硬件监控和系统分析

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 158 / 438
Stars: ★ 30 热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+
凭据: 无需凭据
许可证: BSD-3-Clause
最近提交: 2 个月前
工具数: 11

57FMRS · C

CLIO Node Hardware 是 CLIO Kit 的一部分，提供全面的硬件监控工具，适合 AI 代理在 HPC 环境中进行系统管理和故障排查。它通过标准输入输出提供可靠的信息。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

12/20

维护活跃度

13/20

文档质量

11/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: 清单声明了11个工具、1个资源、1个prompt,描述清晰且粒度合理,tool-list握手所需的静态结构完整。但未提供node-hardware服务器自身的源代码、已提交测试或CI运行证据(README的CI/coverage徽章属于整个仓库,不能归因到该服务器),get_remote_node_info等依赖SSH/nvidia-smi/rocm-smi外部工具的路径缺乏错误处理与降级说明,因此可靠性不能超过12分。
安全与权限 12/20: get_remote_node_info通过SSH采集远程节点信息,是明显的数据边界扩展:凭证如何提供(ssh-agent/密钥?)、主机白名单、命令注入防护均无披露,扣分。其余工具以只读监控为主,无删除/支付/远程执行等红线行为,未发现恶意代码或凭证窃取迹象,不属于红线情形。
维护活跃度 13/20: 仓库未归档,39个开放issue显示有真实使用与响应渠道,BSD-3-Clause许可证明确,由GRC/IIT与NSF资助,团队信息具体。但清单版本2.2.3与PyPI包2.10.6、README安装示例2.4.3三处版本不一致,版本治理混乱,故给予中等分数。
文档质量 11/20: README对整个clio-kit的安装、客户端配置(Cursor/Claude/VS Code)、故障排查较为完善,服务器表格中也列出了node-hardware 2.2.3及安装命令。但缺少该服务器专属文档:各工具参数、权限要求(SSH配置、GPU工具依赖)、限制(Windows支持、容器内传感器不可用)均未说明,文档以仓库级别代替服务器级别,扣分。
安装易用性 12/20: 安装路径清晰:uv tool install后clio-kit mcp-server node-hardware即可运行,并提供了多种客户端JSON配置示例(可按模式改写)。但示例配置只展示了hdf5/pandas/slurm,未给出node-hardware的现成客户端片段;stdio依赖uv及PATH配置,有一定手工步骤,故未达上限。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望在自然语言中访问硬件信息的 AI 代理
需要快速了解系统资源的核心开发人员
管理科学 HPC 工作负载的用户

不适合谁

详细的基准测试或低级别硬件原始数据（超出本服务器范围）
在无法 SSH 访问的远程机器上进行性能监控
需要跨多个节点的高级聚合的监控系统（此处仅提供获取单个远程节点的能力）

所需权限

读取 CPU、内存、磁盘、网络、GPU、传感器和进程信息
在本地系统上执行只读命令（如 nvidia-smi/rocm-smi）
SSH 连接以收集远程节点信息

风险与副作用

如果暴露于 AI 代理，进程和系统信息可能包含敏感数据
GPU 查询可能因驱动或硬件问题而失败
远程监控需要有效的 SSH 凭据，可能存在安全风险

安装接入

准备工作

运行环境：Python 3.10+

安装 uv 包管理器：curl -LsSf https://astral.sh/uv/install.sh | sh 或 pip install uv。
安装 clio-kit：uv tool install 'clio-kit==2.4.3'，然后运行 uv tool update-shell。
在客户端配置 MCP 服务器，例如：{"mcpServers":{"node-hardware":{"command":"clio-kit","args":["mcp-server","node-hardware"]}}}

claude_desktop_config.json

{
  "mcpServers": {
    "node-hardware": {
      "command": "clio-kit",
      "args": [
        "mcp-server",
        "node-hardware"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "node-hardware": {
      "command": "clio-kit",
      "args": [
        "mcp-server",
        "node-hardware"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add node-hardware -- clio-kit mcp-server node-hardware

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 `clio-kit mcp-server node-hardware` 启动服务器，确认 get_cpu_info 和 health_check 等工具出现在 MCP 客户端的工具列表中，然后调用 health_check 验证监控能力状态。

常见排障

确保 clio-kit 已通过 uv tool install 安装并更新 shell
检查 MCP 客户端配置中命令和参数是否正确
验证 GPU 工具（nvidia-smi 或 rocm-smi）是否在系统上可用且可执行
对于远程节点，请检查 SSH 连接性、凭据和防火墙设置

试试这样问

连接成功后，可以直接对 AI 助手这样说：

获取本节点的 CPU 规格和各核心使用率。
检查内存和 swap 的使用百分比。
获取 GPU 型号、温度和利用率。
运行一次完整的系统健康检查，包括磁盘和网络统计。

工具能力 11

get_cpu_info 只读

获取 CPU 规格、核心数、频率和各核心使用率。

get_memory_info 只读

获取内存和交换分区容量、使用百分比和可用性。

get_system_info 只读

获取操作系统详细信息、主机名、运行时间和活动用户。

get_disk_info 只读

获取磁盘分区、使用统计和 I/O 计数器。

get_network_info 只读

获取网络接口、IP 地址和 I/O 统计。

get_gpu_info 只读

通过 nvidia-smi/rocm-smi 获取 GPU 型号、内存、温度和利用率。

get_sensor_info 只读

获取温度、风扇速度和电池传感器读数。

get_process_info 只读

获取运行进程及其 CPU、内存和状态信息。

展开其余 3 个工具

get_performance_info 只读

获取实时 CPU、内存、磁盘和网络性能指标。

get_remote_node_info 只读

通过 SSH 从远程节点收集硬件信息。支持组件过滤。

health_check 只读

验证服务器健康和硬件监控能力状态。

使用场景

获取当前节点的硬件规格和状态

监控远程节点的硬件健康状况

为系统调优收集性能指标

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

CLIO Node Hardware（原 io.github.iowarp/node-hardware-mcp）是一个 MCP 服务器，为 LLM 提供全面的硬件监控和系统分析能力。通过标准输入输出协议运行，提供详细的 CPU、内存、磁盘、网络、GPU、传感器、进程和实时性能信息，并支持通过 SSH 远程节点监控。

同仓库的其他 Server

源版本 93e41d70d6c2 数据同步于 2026-10-19 查看 FMRS 评分方法