Skip to main content
Glama

sh-mcp

Home MCP server: a thin adapter over the BFF. Generic verb tools (turn_on, open, lock, …) + home://* resources rebuilt from the BFF snapshot.

Part of the Smart Home AI system — architecture, the full docker compose stack and the end-to-end tests live in sh-infra.

Run the tests

pip install -r requirements-dev.txt   # pulls sh-common from its public GitHub tag
pytest

Related MCP server: Larnitech MCP

Build the image

docker build -t sh-mcp .              # sh-common resolved from GitHub (public)

--build-arg SH_COMMON_SOURCE=local --build-context sh_common=../sh-common builds against a sibling checkout instead (offline / coordinated changes).

CI

Workflow

Runs

test

pytest with coverage on every PR / main push; fails below the fail_under in pyproject.toml, posts a coverage summary on the PR (check test / coverage)

codeql

CodeQL analysis (Python) on PRs, main, and weekly

ci

builds the Docker image on every PR; on main also pushes ghcr.io/<owner>/sh-mcp:latest + :<sha>

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to connect to smart-home controllers to read device snapshots, watch live state changes, look up type-specific documentation and known vendor quirks, save and compare data snapshots, and perform guarded two-phase writes for lights, climate, blinds, sensors and meters. Writes stay disabled until explicitly enabled, are previewed and token-confirmed before execution, and report what actually landed on the device.
    29 PyPI
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables an Alexa-style assistant to plan and execute multi-step smart home routines, remember user preferences across sessions, and render interactive UI cards on screen via Streamable HTTP MCP tools. Uses AWS Bedrock for reasoning with a built-in offline intent fallback.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to discover, read and control smart-home devices from multiple vendors through a unified capability model, and to author and trigger YAML scenes that a local deterministic engine executes without the AI in the control loop. High-risk actions such as door locks and garage doors are held in a confirmation queue for a human, and every call is written to a local audit log.
    Apache 2.0