← 返回目录
C

CLIO Slurm

社区
面向 HPC 工作负载和作业调度的 MCP 服务器
GitHub 源仓库 ↗
★ 26 Stars 分类 · 其他 热门 源版本 a0bc2ef89393
64FMRS · C

CLIO Slurm 为 Slurm 集群提供了简洁的作业管理接口。工具的命名和功能明确,且确认机制减少了误操作风险。该服务器作为 IoWarp 科学计算工具生态系统的一部分,主要面向 HPC 管理员和希望在研究工作流中利用 AI 的研究人员。作为子系统,其文档在很大程度上依赖整体 CLIO Kit,这可能使单服务器部署时的独立使用变得复杂。

可靠性
10/20
安全与权限
14/20
维护活跃度
14/20
文档质量
12/20
安装易用性
14/20
查看 FMRS 评分方法 →

CLIO Slurm 是一个模型上下文协议 (MCP) 服务器,为 AI 代理提供 Slurm 工作负载管理器的接口。它支持提交作业(包括作业数组)、列出和描述作业、检查集群分区信息以及取消作业。服务器通过 clio-kit 包以 stdio 方式运行,使用命令 clio-kit mcp-server slurm。它是 IoWarp 平台的 CLIO Kit 工具集的一部分,该工具集由伊利诺伊理工学院的研究人员开发,并得到 NSF 支持。该服务器对希望在其科学工作流中自动化 Slurm 作业管理的代理非常有用。

工具能力

slurm_submit
提交单个 Slurm 作业或作业数组,并返回调度程序原生的作业 ID。仅当提交数组时设置数组参数。
slurm_list
列出有限数量的 Slurm 作业,可选用用户、状态和分区过滤。返回原生 ID 和显式的截断状态。
slurm_describe
描述一个调度程序原生的 Slurm 作业:生命周期状态、终态性、调度程序属性以及可选的有限标准输出/标准错误尾部。
slurm_cluster
在单个快照中检查有限的 Slurm 分区和队列记录。默认排除节点详细信息,并在请求时进行限制。
slurm_cancel
请求对单个 Slurm 作业进行破坏性取消。confirm_job_id 必须完全重复 job_id;省略或不匹配将被拒绝,且不会调用 scancel。

安装接入

  1. 确保已安装 Python 3.10+ 和 uv。
  2. 使用 uv tool install 'clio-kit==2.4.3'(或最新版本)安装 CLIO Kit。
  3. 更新 PATH:uv tool update-shell
  4. 在 MCP 客户端中配置服务器,例如:
   {"mcpServers": {"slurm-mcp": {"command": "clio-kit", "args": ["mcp-server", "slurm"]}}}
   
  1. 验证 Slurm 命令(如 sinfosqueuesbatchscancel)在您的环境中可用。

选型与风险

适合谁

  • 需要 Slurm 集群管理的科学计算用户。
  • 希望自动化 HPC 作业生命周期的 AI 代理开发者。

不适合谁

  • 不使用 Slurm 作为调度器的系统(例如 PBS、LSF)。
  • 需要图形界面或交互式终端会话的用户。
  • 偏好手动编写的 Slurm 脚本而非 AI 驱动交互的用户。

所需权限

  • 需要访问 Slurm 命令(`sbatch`、`squeue`、`scontrol`、`scancel`、`sinfo` 等)。
  • 取决于执行环境:能够列出作业,通常只需要用户权限;取消或提交作业可能需要额外的授权。
  • 可能需要访问作业输出文件所在的文件系统。

风险与副作用

  • `slurm_cancel` 工具是破坏性的——它取消作业,可能导致进度丢失。内置的 `confirm_job_id` 机制有助于防止误取消,但如果滥用仍可能造成影响。
  • 资源提交可能消耗大量集群资源,可能影响其他用户。
  • 敏感信息可能通过作业描述或输出泄露。
  • 在共享 HPC 环境中,配置错误可能导致权限问题。

常见排障

  1. 检查 Slurm 命令是否可用:运行 `which sbatch`、`which squeue`。
  2. 确保 `clio-kit` 已正确安装且版本兼容。
  3. 查阅服务器日志以获取详细的错误信息。
  4. 验证您是否拥有足够的 Slurm 用户权限来执行所需操作(例如取消作业)。

使用场景

通过自然语言向 AI 代理提交模拟作业,例如 '将 simulation.py 以 32 核提交到 Slurm'。
监控作业状态并检索输出。
查询集群分区和队列信息。

支持客户端

Claude Desktop完整支持