Skip to content

v0.1.0

Choose a tag to compare

@SDNick484 SDNick484 released this 28 Oct 04:52
· 52 commits to main since this release
2b2517a

First release of mcp-server-harmony: an MCP server that controls one or more Logitech Harmony Hubs over their local websocket API (no Logitech cloud, no Home Assistant), built on aioharmony.

What's in it

  • Tools: get_status, list_activities, list_devices, list_commands, start_activity, power_off, send_command
  • Resources: harmony://hubs and a per-hub catalog; prompt: fix_stuck_remote
  • Activity-first: send_command without a device goes through the running activity
  • Multiple hubs, never guessed: ambiguous calls are refused with the hub names; hub-qualified refs like Den/Watch TV
  • Safety: the hub's config is the allow-list; commands refused mid-sequence; per-hub rate limits; dry-run mode
  • CLI: serve (stdio or --http), check, call, discover, doctor, simulate (wire-level fake hubs)
  • Deploy: Alpine/OpenRC service for an LXC

Verification status

Hardware-verified on real hubs (2026-10-14): H-FRAMES, H-NAME, H-PORT, H-POWEROFF, H-PROVISION (connect, status, names, power off).

Simulator-only so far: H-CONFIG-PUSH, H-CONFIG-SHAPE, H-HOLD, H-PRESS-ERROR, H-PRESS-SILENT, H-RECONNECT, H-SSDP, H-START-SEQUENCE, H-TIMING (activity starts, button presses, reconnects, config pushes). See HARDWARE_VALIDATION.md.

Tested on Python 3.11–3.14.