Skip to main content
Glama
smart-home-ia-sample

sh-mcp

by smart-home-ia-sample
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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: home-assistant-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>

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

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • home-assistant-mcp

    mattmaas
    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.
    99 npm
    1
    MIT

  • lobster-home

    yxy123a
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables natural-language control of home appliances through Home Assistant, exposing tools to list entities and areas, read states and history, call services, activate scenes, render templates, and confirm sensitive actions via one-time tokens. A built-in safety policy restricts it to appliance-class devices, outright denying gas, valves, locks, alarms, security panels, water heaters, door/window covers, and arbitrary-command domains.
    -

  • Larnitech MCP

    mpopovych-thinkhome
    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.
    27 PyPI
    1
    MIT