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: hass-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
    A
    quality
    F
    maintenance
    Enables controlling and querying Home Assistant devices and services via natural language. Supports state retrieval, listing states, and calling any Home Assistant service.
    13
    111 npm
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to control Home Assistant devices, including lights, switches, and climate devices, through natural language commands.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to read Home Assistant entity states, call any service, and optionally apply named scene presets from a catalog using plain-English descriptions.
    144 npm
    MIT