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

Related MCP server: Plugwise MCP Server

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

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