首页 › 龙虾技能列表 › 🏠 Home Assistant via MCP protocol — 技能工具

🏠 🏠 Home Assistant via MCP protocol — 技能工具

v1.0.1

[自动翻译] The skill for control Home Assistant smart home devices and query states using MCP protocol.

8· 3,400·19 当前·20 累计
by @al-one (Alone)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/2/26
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
The skill's requests and instructions match its stated purpose (controlling Home Assistant via MCP); required env vars and the mcporter tool are proportionate and expected.
评估建议
This skill appears to be what it says: it uses the mcporter CLI to talk to a Home Assistant MCP endpoint and needs your HASS_BASE_URL and HASS_ACCESS_TOKEN. Before installing: 1) Verify you trust the mcporter npm package (review its GitHub repo/source and recent releases) instead of blindly installing from npm. 2) Use a Home Assistant token with minimal necessary scope and treat it like a secret; don't paste it into public places. 3) Prefer using npx for ephemeral invocation if you don't want a ...
详细分析 ▾
✓ 用途与能力
Name/description (Home Assistant via MCP) align with requirements: mcporter (or npx) is the MCP CLI and HASS_ACCESS_TOKEN/HASS_BASE_URL are exactly what a Home Assistant MCP client needs.
✓ 指令范围
SKILL.md only instructs using mcporter (or npx mcporter) to call MCP methods and to configure mcporter with HASS_BASE_URL/HASS_ACCESS_TOKEN; it does not request unrelated files, credentials, or system-wide data.
ℹ 安装机制
Install spec uses the 'mcporter' npm package (node). This is an expected way to obtain the MCP CLI but is a moderate-risk install vector (public registry package will be installed/placed on disk). Verify the mcporter package/source before installing.
✓ 凭证需求
Only HASS_ACCESS_TOKEN (primary) and HASS_BASE_URL are required. Both are necessary and proportionate for connecting to a Home Assistant MCP endpoint.
✓ 持久化与权限
The skill does not request always:true and is not asking to modify other skills or system configs; it runs on-demand or autonomously per platform defaults (normal for skills).
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.12026/2/10

- Added homepage and metadata fields to the skill, including requirements and install instructions. - Updated all example commands to use mcporter directly, with a note to use npx if mcporter is not installed. - Improved documentation by clarifying tool usage and environment variable setup. - Enhanced guidance for installation and configuration steps.

● 无害

安装命令 点击复制

官方npx clawhub@latest install mcp-hass
镜像加速npx clawhub@latest install mcp-hass --registry https://cn.clawhub-mirror.com

技能文档

Control Home Assistant smart home and query states using MCP protocol.

Prerequisites

Enable MCP server in Home Assistant:
  • Browse to your Home Assistant instance.
  • Go to Settings > Devices & services.
  • In the bottom right corner, select the + Add Integration button.
  • From the list, select Model Context Protocol.
  • Follow the instructions on screen to complete the setup.

Usage

# Get states
mcporter call home-assistant.GetLiveContext
# Turn on the device
mcporter call home-assistant.HassTurnOn(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOn(name: "Light", area: "Bedroom")
# Turn off the device
mcporter call home-assistant.HassTurnOff(name: "Bedroom Light")
mcporter call home-assistant.HassTurnOff(area: "Bedroom", domain: ["light"])
# Control light
# brightness: The percentage of the light, where 0 is off and 100 is fully lit.
# color: Name of color
mcporter call home-assistant.HassLightSet(name: "Bedroom Light", brightness: 50)
# Control fan
# percentage: The percentage of the fan, where 0 is off and 100 is full speed.
mcporter call home-assistant.HassFanSetSpeed(name: "Fan", area: "Bedroom", percentage: 80)

Execute the following command to learn about specific usage methods:

  • mcporter list home-assistant --schema --all-parameters

Config

When prompted that the MCP server does not exist, remind the user to configure the HASS_BASE_URL and HASS_ACCESS_TOKEN environment variables by executing the following command to add the configuration: 
mcporter config add home-assistant \
  --transport http \
  --url "${HASS_BASE_URL:-http://homeassistant.local:8123}/api/mcp" \
  --header "Authorization=Bearer \${HASS_ACCESS_TOKEN}"

About mcporter

  • When command mcporter does not exist, use npx -y mcporter instead.
  • https://github.com/steipete/mcporter/raw/refs/heads/main/docs/call-syntax.md
  • https://github.com/steipete/mcporter/raw/refs/heads/main/docs/cli-reference.md
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务