Haftungsausschluss: Dies ist ein unabhängiges, von der Community entwickeltes Projekt und nicht mit KegLand oder RAPT.io verbunden, von diesen gebilligt oder unterstützt. RAPT, RaptPill und KegLand sind Marken der jeweiligen Rechteinhaber und werden hier ausschließlich zur Beschreibung der Kompatibilität genannt. Diese Software wird wie besehen bereitgestellt, ohne jegliche Gewährleistung — siehe LICENSE für die vollständigen Bedingungen, einschließlich eines zusätzlichen Haftungsausschlusses in einfacher Sprache, der sich auf die Nutzung einer nicht unterstützten Drittanbieter-API durch dieses Projekt bezieht.

RAPT.io MCP-Server

Ein MCP-Server (Model Context Protocol) zur Überwachung und Steuerung von KegLand-RAPT-Geräten — Fermentationskammern und RaptPill-Hydrometern — über die RAPT.io API.

⚠️ Standardmäßig schreibgeschützt. Die RAPT.io API ist für die meisten mutierenden Operationen nicht unterstützt und nicht dokumentiert (siehe Sicherheits- & API-Nutzungshinweise unten). Dieser Server lehnt alle POST-Requests an die RAPT.io API ab, es sei denn, eine Betreiber:in stimmt explizit über RAPTIO_MCP_READ_ONLY=false zu.

Funktionen

Fermentationskammer

• Liste aller Fermentationskammern anzeigen

• Status abrufen (Temperatur, Heizen/Kühlen, PID, Laufzeiten)

• Telemetrieverlauf abrufen

• (nur wenn RAPTIO_MCP_READ_ONLY=false) Zieltemperatur festlegen, PID aktivieren/deaktivieren, PID-Parameter konfigurieren

RaptPill (Hydrometer)

• Alle RaptPills auflisten

• Status abrufen (Dichte, Temperatur, Akkusstand)

• Telemetrieverlauf abrufen

Allgemein

• Alle gekoppelten Geräte auflisten

• Fermentationsprofile verwalten/ansehen

Mehrere früher verfügbare Steuerungs-Tools (Heizungs-/Kühl-/Lüfter-/Lichtschalter, Hysterese, Kompressor-/Moduswechsel-Verzögerung) wurden entfernt, bis der zugrunde liegende API-Endpunkt verifiziert ist. Siehe Entfernte Tools weiter unten.

Related MCP server: RAPT.io MCP Server

Installation

Voraussetzungen

• Python 3.11+

• uv (empfohlen) oder pip

Mit uv

uv sync --frozen

Mit pip

pip install -e .

Authentifizierung

Dieser Server authentifiziert sich gegenüber der RAPT.io API mit Ihrem RAPT.io-Benutzernamen und einem API-Secret (nicht Ihrem Kontop-Kennwort).

1. Melden Sie sich beim RAPT-Portal an.

2. Gehen Sie zu My Account → API Secrets (https://app.rapt.io/account/apisecrets).

3. Klicken Sie auf Add API Secret und notieren Sie den Wert sofort — er wird serverseitig gehasht und kann später nicht erneut abgerufen werden.

Verwenden Sie für RAPT_API_SECRET auf keinen Fall Ihr tatsächliches Kontopasswort. Das API-Secret ist eine separate, unabhängig widerrufbare Zugangsanmeldedaten — wenn es es sich nennt, können Sie es im Portal allein austauschen, ohne Ihr normales Login zu berühren.

Konfiguration

Konfigurieren der container following Umgebungsvariablenlimits:

Verwendung

Direkt starten (Streamable HTTP)

RAPT_USERNAME="you@example.com" \
RAPT_API_SECRET="your-api-secret" \
RAPTIO_MCP_AUTH_TOKEN="$(openssl rand -hex 32)" \
  uv run raptio-mcp

Der Server lauscht auf http://<RAPTIO_MCP_HOST>:<RAPTIO_MCP_PORT>/mcp (Streamable-HTTP-Transport, zustandslos, JSON-Antworten). Alle Anfragen an /mcp erfordern die obigen Bearer-Token. /healthz ist ohne Authentifizierung erreichbar und für Liveness-/Readiness-Probes des Orchestrators gedacht.

MCP-Client verbinden

Konfiguration linuxes MCP-Clients-Tools für die Nutzung des Streamable-HTTP-Transports, z. B.:

claude mcp add --transport http raptio http://localhost:8000/mcp \
  --header "Authorization: Bearer <your RAPTIO_MCP_AUTH_TOKEN>"

Frühere Versionen dieses Servers verwendeten den Stdio-Transport (for lokale separators with Claude Desktop/Claude Code). Seit 0.2.0 läuft der Server ausschließlich über Streamable HTTP, was den obigen Bearer-Token erfordert — the implizite Vertrauensgrenze durch Prozessbestand (Prozessbesitz) entfällt, daher ist una Automatisierung nicht erforderlich.

Verfügbare Tools

Solange RAPTIO_MCP_READ_ONLY=true (Standard) gilt, werden die drei mutating Tools weiterhin aufgelistet (damit ihre Schemas auffindbar bleiben), jeder Aufruf gibt jedoch instead des Raptio-API einen expliziten Fehler zurück.

Entfernte Tools

Die folgenden Tools existierten in früheren Versionen und wurden entfernt, bis die Verifizierung abgeschlossen ist:

• set_fermentation_chamber_heating_enabled

• set_fermentation_chamber_cooling_enabled

• set_fermentation_chamber_fan_enabled

• set_fermentation_chamber_light_enabled

• set_fermentation_chamber_cooling_hysteresis

• set_fermentation_chamber_heating_hysteresis-Foto

• set_fermentation_chamber_compressor_delay

• set_fermentation_chamber_mode_switch_delay

Alle verwendeten POST /api/FermentationChambers/UpdateFermentationChamber, Endpunkt in RAPT.io's veröffentlichter API-Spezifikation (https://api.rapt.io/swagger/v1/swagger.json) nicht auftaucht und keine dokumentierte Nebenläufigkeitsgarantie. Sie werden erst wieder aufgenommen, wenn Existenz und Sicherheit des Endpunkts harm against account bestätigt wurde. (set_fermentation_chamber_light_enabled hat früher additionally falsche enum-Werte lieufert — On/Off/Auto statt der richtigen AlwaysOn/AlwaysOff/Automatic — and that bug should be fixed before re-inclusion.)

Sicherheits- & API-Nutzungshinweise

Die öffentliche RAPT.io-API wird von KegLand ausdrücklich als nicht unterstützt beschrieben:

„Der Zugriff auf die API wird nicht unterstützt. Das bedeutet, dass Sie keine Unterstützung von KegLand erhalten, wenn Probleme bei der Verwendung der API auftreten... Wenn Sie ein Gerät durch eine missbräuchliche Verwendung der API zerstören, erlischt die Garantie... Die API (Endpunkte, Parameter, Antwortmodelle usw.) ist ohne Vorankündigung Änderungen unterworfen..." — https://docs.rapt.io/integrations/api-secrets

Angesichts dessen verfolgt der Server absolut einen konservativen Ansatz:

• Standardmäßig schreibgeschützt (RAPTIO_MCP_READ_ONLY=true) — Es wird keine Anfrage gesendet, die den Gerätezustand ändern könnte, unless ei ausdrücklich aktiviert wurde.

• Für Mutations only official documented endpoints are used — SetTargetTemperature, SetPIDEnabled, SetPID — allein in RAPT.io zusammen veröffentlichter Swagger-Spec are confirmed.

• Undokumentierte Endpunkte werden nicht verwendet — siehe Entfernte Tools.

• Authentifizierung über den HTTP-Transport ist verpflichtend (RAPTIO_MCP_AUTH_TOKEN), da Streamable HTTP the implicit Vertrauensgrenze from the previously costeligen Stdio-Subprocess-Model of the facade, womit die Authentifizierung verpflichtend wird.

• All mutating tool calls werden im Audit-Log protokolliert (Tool-Name, Argumente, Ergebnis) in the server's structured logs.

Wenn Sie RAPTIO_MCP_READ_ONLY=false setzen, entscheiden Sie sich aktiv dazu, Befehle über die physische Brhous-/Fermentationshardware gesendet durch eine API, die KegLand ohne Vorankündigung geben kann; jegliche Schäden oder Restriktionen dieBare durch diese Nutzung entstehen, red liegen nach den obigen Bedingungen von KegLand Ihr Verantwortung.

I’m tauscht der Server Ihre RAPT_USERNAME und RAPT_API_SECRET gegen ein kurzlebiges Bearer-Token, das über den OAuth2 Resource Owner Password Credentials Grant gegen https://id.rapt.io/connect/token ausgetauscht wird, gemäß dem dokumentierten Ablauf von RAPT.io. Tokens werden im Speicher zwischengespeichert und automatisch ~30 Sekunden vor Ablauf aktualisiert.

Lizenz

MIT