Skip to content

Usage

CLI

The classic continuous service polls temperature and adjusts the fans:

fan-manager --intensity 5 --cold 50 --warm 80 --slow 5 --fast 100 --poll-rate 24
Flag Meaning
-i, --intensity Temperature power intensity (logarithmic, 0-10)
-c, --cold Minimum temperature for fan scaling (°C)
-w, --warm Maximum temperature for fan scaling (°C)
-s, --slow Minimum fan speed (0-100)
-f, --fast Maximum fan speed (0-100)
-p, --poll-rate Temperature poll rate (seconds)

The Api facade

from fan_manager.api_client import Api

api = Api()
api.get_temp()                 # {"response": 64.0, "command": "sensors -j", "status": 200}
api.set_fan(fan_level=40)      # set fans to 40%
api.auto_set_fan_speed(minimum_fan_speed=5, maximum_fan_speed=100)

MCP tools

The MCP server exposes one typed tool per operation. Arguments are passed by name.

Temperature (CONCEPT:FM-OS.governance.service-reads-temperature-through)

{ "tool": "fan_manager_get_temp", "arguments": {} }
{ "tool": "fan_manager_get_core_temp", "arguments": { "cpus": ["coretemp-isa-0000"], "sensors": {} } }

Fan control (CONCEPT:FM-OS.governance.service-writes-fan-level)

{ "tool": "fan_manager_set_fan", "arguments": { "fan_level": 40 } }
{ "tool": "fan_manager_auto_set_fan_speed", "arguments": { "minimum_fan_speed": 5, "maximum_fan_speed": 100, "minimum_temperature": 50, "maximum_temperature": 80, "temperature_power": 5 } }

Running the MCP server

fan-manager-mcp                                              # stdio (default)
fan-manager-mcp --transport streamable-http --host 0.0.0.0 --port 8000