Agentic Ventures Wiki

mcp-hetzner

2 Min. Lesezeit

mcp-hetzner — Capability Repo

Lokaler Klon von dkruyt/mcp-hetzner.

Pfad

~/source/mcps/mcp-hetzner/

Was es ist

Python-MCP-Server der Hetzner Cloud API als 27 strukturierte Tools fuer LLMs exponiert. 5 Resource-Domains: Server, Volume, Firewall, SSH-Key, Info (Images/Server-Types/Locations).

Warum geklont statt einfach installiert

  • AV-Konvention: alle MCPs liegen in ~/source/mcps/ (siehe lokale-source-repos)
  • Source-Edit + Reload Pattern: bei API-Updates oder Tool-Erweiterungen koennen wir direkt im Source editieren (uv pip install -e . ist editable installiert)
  • Audit-Trail: wir sehen welche Version wir haben, koennen Diffs gegen Upstream pruefen
  • Fork-Bereitschaft: falls dkruyt das Projekt aufgibt oder wir Features ergaenzen wollen (z.B. Object-Storage-Tools), haben wir den Code lokal

Fork-Pfad (deferred)

Aktuell: plain Klon vom Upstream, keine eigenen Patches.

Wenn wir Object-Storage-Tools dazu bauen wollen (eigenes Mini-Projekt via mcp-eigenbau-Skill):

  1. Fork auf GitHub marvin-khl/mcp-hetzner (oder AV-Org sobald angelegt)
  2. Branch feature/object-storage-tools mit neuen Tools (S3-API-Wrapper)
  3. Tests + PR-Upstream gegen dkruyt
  4. Wenn nicht akzeptiert: eigener Maintain-Branch

Setup-Status

Live seit 2026-05-13. Smoke-Test via mcp__hetzner__list_locations gruen — 6 Datacenter-Locations zurueck. MCP-Registration in ~/.claude.json mit 1Password-CLI-Wrapper laeuft. Reproduktions-Steps (fuer neue Maschine) siehe setup.

cd ~/source/mcps/
git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner
uv tool install --force --editable .

Tests

Upstream-Tests: pytest im Repo-Root.

Updates aus Upstream

cd ~/source/mcps/mcp-hetzner
git fetch origin
git pull origin main
uv pip install -e .  # bei Dependency-Aenderungen

Vor Upstream-Update: lokale Patches stashen (git stash) falls vorhanden, danach re-applien.

  • hetzner — MCP-Konfig + Tool-Liste
  • _index — alle Repos
  • _index — Hetzner-Capability-Dashboard

Graphansicht