Skip to main content
Glama
RAPT.io MCP Server

RAPT.io MCP Server

by tobiask1977

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

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

Available Tools

23 tools
get_bonded_deviceA

Get details for a specific bonded device by UUID.

Inputs: device_id (required).

get_bonded_devicesA

List all devices bonded to the RAPT account (all device types).

Inputs: no named parameters.

get_bonded_device_telemetryC

Get telemetry data for a bonded device.

Inputs: device_id (required), end_date, start_date.

get_fermentation_chamberA

Get detailed status of a single fermentation chamber including current temperature, target temperature, PID settings, heating/cooling state, run-time statistics, and active profile.

Inputs: chamber_id (required).

get_fermentation_chambersA

List all fermentation chambers (Gärschränke) in the RAPT account.

Inputs: no named parameters.

get_fermentation_chamber_telemetryA

Get historical telemetry data for a fermentation chamber, including temperature readings, compressor/heating run times, and profile progress.

Inputs: chamber_id (required), end_date, start_date, profile_session_id.

get_hydrometerA

Get detailed status of a single RaptPill hydrometer including current gravity (specific gravity), gravity velocity, temperature, and battery level.

Inputs: hydrometer_id (required).

get_hydrometersA

List all hydrometers (RaptPill devices) in the RAPT account. Returns current gravity, temperature, and battery level.

Inputs: no named parameters.

get_hydrometer_telemetryA

Get historical telemetry data for a RaptPill hydrometer. Returns timestamped gravity, temperature, and battery readings.

Inputs: hydrometer_id (required), end_date, start_date, profile_session_id.

get_profileA

Get details of a specific fermentation profile including all steps and alerts.

Inputs: profile_id (required).

get_profilesA

List all fermentation profiles saved in the RAPT account.

Inputs: no named parameters.

get_profile_typesA

List all available profile types in the RAPT system.

Inputs: no named parameters.

set_fermentation_chamber_compressor_delayA

Set the compressor restart delay in minutes for a fermentation chamber. Valid range: 2–10.

Inputs: minutes (required), chamber_id (required).

set_fermentation_chamber_cooling_enabledA

Enable or disable the cooling (compressor) of a fermentation chamber.

Inputs: enabled (required), chamber_id (required).

set_fermentation_chamber_cooling_hysteresisA

Set the cooling hysteresis (deadband) for a fermentation chamber. Valid range: 0.5–10.

Inputs: value (required), chamber_id (required).

set_fermentation_chamber_fan_enabledA

Enable or disable the fan of a fermentation chamber.

Inputs: enabled (required), chamber_id (required).

set_fermentation_chamber_heating_enabledB

Enable or disable the heating element of a fermentation chamber.

Inputs: enabled (required), chamber_id (required).

set_fermentation_chamber_heating_hysteresisB

Set the heating hysteresis (deadband) for a fermentation chamber. Valid range: 0.1–10.

Inputs: value (required), chamber_id (required).

set_fermentation_chamber_light_enabledB

Control the light of a fermentation chamber (On, Off, or Auto).

Inputs: state (required), chamber_id (required).

set_fermentation_chamber_mode_switch_delayA

Set the heating/cooling mode switch delay in minutes for a fermentation chamber. Valid range: 2–30.

Inputs: minutes (required), chamber_id (required).

set_fermentation_chamber_pidB

Configure PID parameters (proportional, integral, derivative) for a fermentation chamber's temperature controller.

Inputs: d (required), i (required), p (required), chamber_id (required).

set_fermentation_chamber_pid_enabledA

Enable or disable PID temperature control for a fermentation chamber.

Inputs: enabled (required), chamber_id (required).

set_fermentation_chamber_temperatureA

Set the target temperature for a fermentation chamber. The value is in the unit configured on the device (°C or °F).

Inputs: target (required), chamber_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools target distinct resources, but get_bonded_device_telemetry overlaps with resource-specific telemetry endpoints, and get_bonded_device vs get_fermentation_chamber could confuse agents unfamiliar with the domain. Descriptions mostly clarify these boundaries.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern: get_* for reads, set_* for writes, and plural forms for list operations. This makes the API highly predictable and easy to navigate.

    Tool Count4/5

    With 23 tools, the server is slightly heavy, but the count is justified by the breadth of resources (devices, chambers, hydrometers, profiles) and the granular control offered for fermentation chambers. No redundant tools exist.

    Completeness3/5

    The server covers monitoring and direct control well, but lacks profile management (create/update/delete) and the ability to assign or start a profile on a chamber. These are notable gaps for a fermentation control system, though core read/control workflows are present.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables control and monitoring of Plugwise smart home devices including thermostats, switches, and energy meters with automatic network discovery. Supports temperature control, energy monitoring, and multi-hub management through natural language commands.
      16
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables control and monitoring of Tesla vehicles through the Tessie API, providing access to vehicle state (battery, location, climate) and commands (lock/unlock, climate control, navigation) with support for both local and Cloudflare Worker deployment.
      11
      MIT