#!/usr/bin/env python3
"""
Homelab Orchestrator — MCP-Server für Lucy (Hermes), seit 25.09.2026.

Stdio-MCP-Server, von Hermes Gateway als Unterprozess gestartet (auf der KI-Box, mit dem venv von MC2). Gibt Lucy die
Knöpfe des Orchestrators: Lage lesen, Updates starten, „Alle aktualisieren“, Dienste neu starten, Kernel aufräumen,
Host neu starten, Modell-Radar. Die Logik steht in orchestrator_werkzeuge.py (ohne MCP testbar); alles geht über die
REST-API von MC2 mit denselben Leitplanken wie die Knöpfe der Oberfläche.

Die Beschreibungen sind bewusst als Leitplanken formuliert (Lesen jederzeit, Handeln nur auf Bitte des Commanders),
damit das Modell nicht auf eigene Faust Updates oder Neustarts auslöst — der Grund jeder Aktion wird protokolliert.
FastMCP liest die Beschreibung beim Anmelden, deshalb steht sie in description= (orchestrator_werkzeuge.BESCHREIBUNG).

Einrichten auf der Box (einmal): hermes mcp add homelab-orchestrator --command <venv>/bin/python --args <dieses Skript>
"""

import orchestrator_werkzeuge as w
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("homelab-orchestrator")
B = w.BESCHREIBUNG


@mcp.tool(description=B["lage"])
def lage() -> str:
    return w.lage()


@mcp.tool(description=B["updates"])
def updates() -> str:
    return w.updates()


@mcp.tool(description=B["speicher"])
def speicher() -> str:
    return w.speicher()


@mcp.tool(description=B["protokoll"])
def protokoll(anzahl: int = 15) -> str:
    return w.protokoll(anzahl)


@mcp.tool(description=B["radar"])
def radar() -> str:
    return w.radar()


@mcp.tool(description=B["update_starten"])
def update_starten(ziel: str, baustein: str, grund: str) -> str:
    return w.update_starten(ziel, baustein, grund)


@mcp.tool(description=B["alle_aktualisieren"])
def alle_aktualisieren(bereich: str, grund: str) -> str:
    return w.alle_aktualisieren(bereich, grund)


@mcp.tool(description=B["nach_updates_suchen"])
def nach_updates_suchen(grund: str) -> str:
    return w.nach_updates_suchen(grund)


@mcp.tool(description=B["dienst_neustarten"])
def dienst_neustarten(dienst: str, grund: str) -> str:
    return w.dienst_neustarten(dienst, grund)


@mcp.tool(description=B["kernel_aufraeumen"])
def kernel_aufraeumen(grund: str) -> str:
    return w.kernel_aufraeumen(grund)


@mcp.tool(description=B["host_neustarten"])
def host_neustarten(grund: str) -> str:
    return w.host_neustarten(grund)


@mcp.tool(description=B["radar_testen"])
def radar_testen(kandidat: str, grund: str) -> str:
    return w.radar_testen(kandidat, grund)


@mcp.tool(description=B["radar_suchen"])
def radar_suchen(grund: str) -> str:
    return w.radar_suchen(grund)


if __name__ == "__main__":
    mcp.run()