MCP 服务器

mcp-httc

MCP server for controlling Honeywell Total Connect Comfort thermostats, enabling remote management of multiple thermostats through Claude interfaces. It provides tools for monitoring temperatures, adjusting setpoints, and changing system modes for thermostat control.

README

mcp-httc

MCP server wrapping Honeywell Total Connect Comfort (legacy mytotalconnectcomfort.com) so John can drive Deer Park UMC's 13 thermostats from any Claude surface.

Sister projects on the same Raspberry Pi: mcp-ui, mcp-google, mcp-pco.

Stack: Python 3.13, FastAPI, FastMCP, AIOSomecomfort, aiohttp.
Backend: AIOSomecomfort (the same library Home Assistant uses) — the only Python/JS option that keeps up with Honeywell's periodic portal breakages.
Transport: Streamable HTTP only; OAuth 2.1 with HS256 JWTs and a shared login password (1:1 port of mcp-ui's auth model).
Deployment: systemd on the Pi, Cloudflare Tunnel ingress at https://httc.1421mcps.com. See references/2026-04-16_initial-deployment.md once the first deploy is written up.

Tools (v1)

Tool	Purpose
`list_thermostats`	All devices with current temp, humidity, mode, fan, setpoints, hold state
`get_thermostat`	One device by name (case-insensitive) or numeric id
`set_setpoint`	Heat and/or cool setpoint with `hold_type` ∈ {temporary, permanent, cancel}
`set_mode`	System mode: heat / cool / auto / off
`set_fan_mode`	Fan: auto / on / circulate
`set_humidity_setpoint`	Humidity setpoint (only on devices that have a humidifier)

Schedule read/write and background polling/monitoring are out of scope for v1.

Deploy a code change

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"'