RAPT.io MCP Server

Ein MCP (Model Context Protocol) Server zum Überwachen und Steuern von KegLand RAPT-Geräten – Gärschränken (Fermentation Chambers) und RaptPill-Hydrometern – über die RAPT.io API.

Funktionen

Gärschrank (Fermentation Chamber)

• Alle Gärschränke auflisten
• Status abrufen (Temperatur, Heizen/Kühlen, PID, Laufzeiten)
• Solltemperatur setzen
• PID-Regler ein-/ausschalten
• PID-Parameter (P, I, D) konfigurieren
• Telemetrieverlauf abrufen

RaptPill (Hydrometer)

• Alle RaptPills auflisten
• Status abrufen (Stammwürze/Gravity, Temperatur, Akkustand)
• Telemetrieverlauf abrufen

Allgemein

• Alle gebundenen Geräte auflisten
• Fermentationsprofile verwalten

Installation

Voraussetzungen

• Python 3.11+
• uv (empfohlen) oder pip

Mit uv installieren

uv sync

Mit pip installieren

pip install -e .

Konfiguration

Setze deine RAPT-Zugangsdaten als Umgebungsvariablen:

export RAPT_USERNAME="deine@email.com"
export RAPT_PASSWORD="deinPasswort"

Verwendung

Direkt starten

RAPT_USERNAME="..." RAPT_PASSWORD="..." uv run raptio-mcp

Claude Desktop Integration

Füge folgendes zu deiner claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "raptio": {
      "command": "uv",
      "args": ["--directory", "/pfad/zum/raptio_mcp", "run", "raptio-mcp"],
      "env": {
        "RAPT_USERNAME": "deine@email.com",
        "RAPT_PASSWORD": "deinPasswort"
      }
    }
  }
}

Claude Code Integration

claude mcp add raptio -- uv --directory /pfad/zum/raptio_mcp run raptio-mcp

Dann Umgebungsvariablen setzen:

claude mcp add raptio -e RAPT_USERNAME=deine@email.com -e RAPT_PASSWORD=deinPasswort -- uv --directory /pfad/zum/raptio_mcp run raptio-mcp

Verfügbare Tools

Tool	Beschreibung
get_bonded_devices	Alle gebundenen Geräte auflisten
get_bonded_device	Einzelnes Gerät abrufen
get_bonded_device_telemetry	Telemetrie eines Geräts abrufen
get_fermentation_chambers	Alle Gärschränke auflisten
get_fermentation_chamber	Status eines Gärschranks abrufen
set_fermentation_chamber_temperature	Solltemperatur setzen
set_fermentation_chamber_pid_enabled	PID ein-/ausschalten
set_fermentation_chamber_pid	PID-Parameter konfigurieren
get_fermentation_chamber_telemetry	Temperaturverlauf abrufen
get_hydrometers	Alle RaptPills auflisten
get_hydrometer	Status einer RaptPill abrufen
get_hydrometer_telemetry	Gravity-/Temperaturverlauf abrufen
get_profiles	Alle Fermentationsprofile auflisten
get_profile	Profil-Details abrufen
get_profile_types	Verfügbare Profiltypen auflisten

Authentifizierung

Der Server verwendet OAuth2 Password Grant gegen https://id.rapt.io/connect/token mit deinen RAPT.io-Zugangsdaten. Das Token wird automatisch erneuert.

Lizenz

MIT