Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Rackhands

БесплатноНе проверен

Out-of-band server management for humans and AI agents: Redfish (iDRAC, iLO, XCC, Supermicro) with IPMI fallback. Read-only by default; dangerous ops need two k

GitHubEmbed

Описание

Out-of-band server management for humans and AI agents: Redfish (iDRAC, iLO, XCC, Supermicro) with IPMI fallback. Read-only by default; dangerous ops need two keys + confirmation. CLI + MCP server, single Go binary.

README

rackhands logo

rackhands

Remote hands for your racks, for you and your AI agent. One binary that reads and operates server BMCs across vendors. Redfish on Dell iDRAC, HPE iLO, Lenovo XCC, Supermicro and any DMTF-conformant BMC, with IPMI as the fallback. Nothing that can take a machine down runs until you allow it and confirm it.

Every vendor speaks its own Redfish dialect. The hardware log is Sel on iDRAC, IML on iLO, PlatformLog on XCC and Log1 on Supermicro. The health rollup hides in a different OEM block on each, and each one accepts a different set of reset types. Older and cheaper boxes speak only IPMI. The existing Redfish MCP servers either cover one vendor, or give an agent set_power_state with nothing in between. rackhands normalises the reads and puts every dangerous operation behind two keys, a plan and a confirmation.

demo

Landing page: https://blackman99.github.io/rackhands/ · Docs: https://blackman99.github.io/rackhands/docs/

Install

go install github.com/Blackman99/rackhands/cmd/rackhands@latest

Or download a single static binary for linux / macOS / windows from Releases.

Usage

$ rackhands health
CRITICAL  db-01  (Dell, via redfish)
   Critical  subsystem power supplies  — iDRAC rollup
   Critical  subsystem storage  — iDRAC rollup
   Critical  psu PS2 Status  — reading 0 W
   Critical  drive Physical Disk 0:1:2  — failed · HDD 2.4 TB ST2400MM0129 · Bay 2 · S/N WBN0K2L7 · on PERC H755 Front
   Warning   volume pgdata  — degraded · RAID5 4.8 TB · on PERC H755 Front
   storage   1 controller · 5 drives (1 Critical) · 2 volumes (1 Warning)
CRITICAL  web-07  (HPE, via redfish)
   Critical  fan Fan 3  — reading 0 %
   Warning   drive Drive 0  — 6% media life left · SSD 1.6 TB MO001600JWTBT · Slot=12:Port=1I:Box=1:Bay=1 · S/N S5H0NA0R301442 · on HPE MR416i-a Gen10+
   Warning   drive Drive 2  — failure predicted · HDD 4 TB MB004000JWJTT · Slot=12:Port=1I:Box=1:Bay=3 · S/N ZC1A7K2Q · on HPE MR416i-a Gen10+
   storage   1 controller · 4 drives (2 Warning) · 2 volumes
OK        k8s-12  (Lenovo, via redfish)
   storage   1 controller · 2 drives · 1 volume
WARNING   lab-x10  (Supermicro, via ipmi (fallback))
   Warning   temperature PSU2 Temp  — reading 117 C
   storage   not checked: IPMI has no controller, drive or RAID volume data (needs Redfish)
$ rackhands events web-07 --min critical      # iLO IML, same shape as the iDRAC SEL
$ rackhands power db-01 force-off
rackhands: operation not allowed: "power" is off; start with --allow power (dangerous operations are disabled by default)

Targets live in ~/.config/rackhands/targets.yaml (example). Use --host https://bmc --user root for a one-off.

Storage: health reads RAID controllers, drives and volumes too, and a failed drive or a degraded volume is enough to make it exit 1. rackhands storage [TARGET...] prints the full tables (add --problems for only what is not OK, --json for scripts). A drive also counts as a Warning when the BMC still says OK but predicts a failure, or reports less than 10% media life left. rackhands handles the PERC RAID.SL.* / RAID.Integrated.* ids and RaidStatus on Dell, the iLO 4 Smart Array OEM tree (SmartStorage) on HPE, drives that Supermicro links from /Chassis, and BMCs that only have SimpleStorage. It is a read: it needs no --allow, writes nothing and is not audited. IPMI has no storage data, so an IPMI-only target says "needs Redfish" and rackhands does not guess.

$ rackhands storage db-01 --problems
CRITICAL  db-01  (Dell, via redfish, Storage)  1 controller · 5 drives (1 Critical) · 2 volumes (1 Warning)
  DRIVE                MEDIA    SIZE    HEALTH    LOCATION  NOTE
  Physical Disk 0:1:2  SAS HDD  2.4 TB  Critical  Bay 2     Failed
  VOLUME  RAID   SIZE    HEALTH   DRIVES  STATE
  pgdata  RAID5  4.8 TB  Warning  3       Degraded

TLS: BMCs usually ship a self-signed certificate. insecure: true is the lazy default; prefer pinning the leaf SHA-256 with tls_fingerprint: (print it with rackhands tls-fingerprint TARGET) or a real ca_file with insecure: false. When tls_fingerprint is set it is the trust model for that target — a mismatch fails closed and does not fall through to insecure.

Dangerous operations (power, boot, bmc-reset, firmware, virtual-media) need all of the following:

  • --allow CLASS when you start rackhands.
  • allow: [CLASS] on that target in the config.
  • Exactly one named target.
  • A confirmation: you type the target name, or pass --yes <name>. Over MCP it is a single-use token, bound to the exact request, that the agent only gets back after it shows you the plan.

Every plan and execution is appended to an audit log. --dry-run shows the exact request and stops.

Watching a firmware update: add --wait and rackhands follows the task the BMC returns until it ends. It reads the Redfish Task or task monitor, the iDRAC job on Dell, and the UpdateService flash state on HPE iLO 5. It keeps polling while the BMC restarts to apply its own firmware and stops at wait_timeout (default 30m). Ctrl-C stops the watching, not the update. The outcome (state, BMC-side duration) goes into the audit log next to the execution. --wait opens no gate: the update still needs --allow firmware, allow: and the confirmation.

$ rackhands --allow firmware firmware-update db-01 https://repo/iDRAC.EXE --yes db-01 --wait
SENT  db-01: accepted (HTTP 202), task /redfish/v1/TaskService/Tasks/JID_001
      watching JID_001 until it ends (at most 30m; Ctrl-C stops watching, not the update)
WAIT  db-01 JID_001  Running      40% ████░░░░░░  Installing the iDRAC firmware package.  12s
DONE  db-01: JID_001 completed in 3m02s — Job completed successfully.

rackhands task TARGET lists tasks and jobs, and rackhands task TARGET ID --wait watches one. Both are read-only and need no --allow. A Dell job scheduled for the next reboot ends as STAGED (exit 0). A failed, cancelled or timed-out task exits 4, and the last line says why and what to run next.

For agents: rackhands mcp is an MCP server on stdio. It is read-only by default; get_health carries the storage section and get_storage returns the full controller / drive / volume lists. Dangerous tools are not even listed unless their class is allowed.

Defence in depth: give the agent a read-only BMC account. rackhands' gate lives in rackhands. The strongest guarantee lives in the BMC: an account with the Redfish ReadOnly role (iLO: no Virtual Power and Reset / iLO Config privileges) or IPMI User privilege cannot power anything off, whatever runs with it. Every read command works with such an account. Keep a separate, privileged config for humans. rackhands inventory (and the MCP get_inventory tool) shows the effective privilege of the account each target logs in with, read-only, and warns when a target with no dangerous allow: classes logs in as Operator or Administrator:

$ rackhands inventory
TARGET  VIA      VENDOR      …  POWER  ACCOUNT
db-01   redfish  Dell        …  On     rackhands-ro (ReadOnly)
x11     redfish  Supermicro  …  On     ADMIN (Administrator, can power off)
WARN  x11: logs in as Administrator, which can power off or reconfigure this machine, but no dangerous class is allowed for it; use a read-only BMC account (Redfish ReadOnly role, IPMI User privilege)
{"mcpServers": {"rackhands": {"command": "rackhands", "args": ["mcp"], "env": {"BMC_PASSWORD": "…"}}}}

CI runs the binary against the DMTF Redfish-Mockup-Server, serving the DMTF mockup plus Dell, HPE (iLO 5 and iLO 4), Lenovo and Supermicro mockups, and against OpenIPMI ipmi_sim (test/integration.sh).

See GOAL.md, ROADMAP.md, CONTRIBUTING.md. MIT licensed.

from github.com/Blackman99/rackhands

Установка Rackhands

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/Blackman99/rackhands

FAQ

Rackhands MCP бесплатный?

Да, Rackhands MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Rackhands?

Нет, Rackhands работает без API-ключей и переменных окружения.

Rackhands — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Rackhands в Claude Desktop, Claude Code или Cursor?

Открой Rackhands на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
85

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Rackhands with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai