HiveOS MCP Server

Serveur MCP (FastMCP) qui permet à Claude de lire les stats de ton rig HiveOS et, une fois activé, d'appliquer des overclocks et des flight sheets.

Tools exposés

Lecture (toujours actifs) :

• get_farm_stats — hashrate total, conso, workers online
• list_workers — résumé de chaque rig
• get_worker — détail complet d'un worker
• get_gpu_stats — stats par GPU (temp, fan, power, hashrate, clocks)
• list_oc_profiles, get_worker_oc
• list_flight_sheets

Écriture (si MCP_ENABLE_WRITE=true) :

• set_manual_oc — OC par GPU (core/mem/PL/fan)
• apply_oc_profile
• create_flight_sheet, apply_flight_sheet
• worker_command — reboot / miner restart-stop-start uniquement

Déploiement

# 1. Copier le projet sur le PC Ubuntu puis :
cp .env.example .env
nano .env          # remplir HIVEOS_TOKEN, HIVEOS_FARM_ID

# 2. Générer le token d'auth du serveur MCP
openssl rand -hex 32   # -> coller dans MCP_AUTH_TOKEN

# 3. Créer le tunnel Cloudflare
#    dash.cloudflare.com -> Zero Trust -> Networks -> Tunnels -> Create tunnel
#    - Type : Cloudflared
#    - Copier le token du tunnel -> CLOUDFLARE_TUNNEL_TOKEN dans .env
#    - Public hostname : ex. hiveos-mcp.tondomaine.com
#      Service : HTTP  ->  hiveos-mcp:8000
#      (le nom "hiveos-mcp" = nom du service docker, résolu dans le réseau compose)

# 4. Lancer
docker compose up -d --build

# 5. Vérifier en local
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/mcp
# 401 attendu (auth requise) => le serveur tourne

Connexion à Claude.ai

Settings -> Connectors -> Add custom connector :

• URL : https://hiveos-mcp.tondomaine.com/mcp
• Authentification : Bearer token -> coller la valeur de MCP_AUTH_TOKEN

Puis dans une conversation, active le connecteur et demande par exemple : « Montre-moi les stats GPU de mon rig ».

Passage en écriture

Une fois la lecture validée :

sed -i 's/MCP_ENABLE_WRITE=false/MCP_ENABLE_WRITE=true/' .env
docker compose up -d

Sécurité

• Le port 8000 n'est bindé que sur 127.0.0.1 : seul le tunnel y accède.
• Toute requête sans Authorization: Bearer <MCP_AUTH_TOKEN> reçoit un 401.
• Les commandes worker sont limitées à une liste blanche.
• Le token HiveOS ne quitte jamais le serveur.
• Option en plus : ajouter Cloudflare Access devant le hostname pour restreindre par email/pays.