Skip to content

fan-manager

Dell PowerEdge Fan Controller + MCP Server + A2A Agent for the agent-utilities ecosystem — a local, action-routed connector for temperature monitoring and IPMI fan control.

Official documentation

This site is the canonical reference for fan-manager, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

fan-manager controls Dell PowerEdge fan speed based on CPU temperature. It provides:

  • Api — a local-command facade (fan_manager.api_client.Api) wrapping the real callables (get_temp, set_fan, auto_set_fan_speed, run_service).
  • Action-routed MCP tools — two consolidated, togglable tool modules (temperature, fan-control) that minimize token overhead in LLM contexts.
  • An A2A agent server — a Pydantic-AI graph agent (console script fan-manager-agent) that calls the MCP tool surface and exposes an AG-UI.

Fan Manager is a local tool: there are no remote credentials. It requires ipmitool and lm-sensors on the host and privileges to issue raw IPMI commands.

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, env config.
  • Usage — the MCP tools, the Api facade, and the CLI.
  • Overview — the action-routed tool surface and architecture.
  • Concepts — the CONCEPT:FAN-* registry.

Quick start

pip install "fan-manager[mcp]"
fan-manager-mcp                   # stdio MCP server (default transport)

Run the classic CLI service:

fan-manager --intensity 5 --cold 50 --warm 80 --slow 5 --fast 100 --poll-rate 24