fan-manager 1.0.0

Manager your Dell PowerEdge Fan Speed with this handy tool and MCP Server!

Fan-Manager

Version: 1.0.0

Manager your Dell PowerEdge Fan Speed with this handy tool!

MCP Server for Agentic AI! Get started with Pip or Docker as well

This repository is actively maintained - Contributions are welcome!

Contribution Opportunities:

• Increase support of Dell PowerEdge Devices
• Support Non-PowerEdge Devices
• Support Non-Dell Devices

Usage:

Short Flag	Long Flag	Description
-h	--help	See usage for fan-manager
-i	--intensity	Intensity of Fan Speed - Scales Logarithmically (0-10)
-c	--cold	Minimum Temperature for Fan Speed
-w	--warm	Maximum Temperature for Fan Speed
-s	--slow	Minimum Fan Speed
-f	--fast	Maximum Fan Speed
-p	--poll-rate	Poll Rate for CPU Temperature in Seconds

Example:

Python

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

Docker Compose

Fan Manager

---
services:
  fan-manager:
    image: knucklessg1/fan-manager:latest
    container_name: server_fan_speed
    privileged: true
    environment:
      MODE: "fan-manager"
      INTENSITY: ${INTENSITY}
      COLD: ${COLD}
      WARM: ${WARM}
      SLOW: ${SLOW}
      FAST: ${FAST}
      POLL_RATE: ${POLL_RATE}
    volumes:
      - /dev/ipmi0:/dev/ipmi0
    restart: unless-stopped

Fan Manager MCP Server

---
services:
  fan-manager-mcp:
    image: knucklessg1/fan-manager:latest
    container_name: server_fan_speed
    privileged: true
    environment:
      MODE: "fan-manager-mcp"
      HOST: 0.0.0.0
      PORT: 8030
      TRANSPORT: "http"
    volumes:
      - /dev/ipmi0:/dev/ipmi0
    restart: unless-stopped

Docker Run

docker run -it -d knucklessg1/fan-manager:latest fan-manager

Docker Compose

docker-compose up --build -d

Use with AI

Configure mcp.json

Recommended: Store secrets in environment variables with lookup in JSON file.

For Testing Only: Plain text storage will also work, although not recommended.

{
  "mcpServers": {
    "fan-manager": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fan-manager",
        "fan-manager-mcp"
      ],
      "timeout": 200000
    }
  }
}

Installation Instructions:

Install Python Package

python -m pip install fan-manager

Repository Owners: