Skip to main content
Glama
deenesjakoruzh
john-r-black

mcp-httc

by john-r-black
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

mcp-httc

MCP-Server als Wrapper für Honeywell Total Connect Comfort (Legacy mytotalconnectcomfort.com), damit John die 13 Thermostate der Deer Park UMC von jeder Claude-Oberfläche aus steuern kann.

Schwesterprojekte auf demselben Raspberry Pi: mcp-ui, mcp-google, mcp-pco.

  • Stack: Python 3.13, FastAPI, FastMCP, AIOSomecomfort, aiohttp.

  • Backend: AIOSomecomfort (dieselbe Bibliothek, die Home Assistant verwendet) — die einzige Python/JS-Option, die mit den periodischen Portal-Ausfällen von Honeywell Schritt hält.

  • Transport: Nur streambares HTTP; OAuth 2.1 mit HS256 JWTs und einem gemeinsamen Login-Passwort (1:1-Portierung des Auth-Modells von mcp-ui).

  • Bereitstellung: systemd auf dem Pi, Cloudflare Tunnel Ingress unter https://httc.1421mcps.com. Siehe references/2026-04-16_initial-deployment.md, sobald die erste Bereitstellung dokumentiert ist.

Tools (v1)

Tool

Zweck

list_thermostats

Alle Geräte mit aktueller Temperatur, Luftfeuchtigkeit, Modus, Lüfter, Sollwerten, Haltestatus

get_thermostat

Ein Gerät nach Name (Groß-/Kleinschreibung ignoriert) oder numerischer ID

set_setpoint

Heiz- und/oder Kühlsollwert mit hold_type ∈ {temporary, permanent, cancel}

set_mode

Systemmodus: heat / cool / auto / off

set_fan_mode

Lüfter: auto / on / circulate

set_humidity_setpoint

Feuchtigkeitssollwert (nur bei Geräten mit Luftbefeuchter)

Zeitplan-Lese-/Schreibvorgänge sowie Hintergrund-Polling/-Überwachung sind nicht Teil von v1.

Codeänderung bereitstellen

git push origin main
ssh 1421mcp 'cd mcp-httc && git pull && \
  .venv/bin/pip install -r requirements.txt && \
  sudo systemctl restart mcp-httc && \
  sudo journalctl -u mcp-httc -f --since "10 seconds ago"'

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors