
Mcp Homeassistant
io.github.daedalus由 GitHub 账号 daedalus 发布v0.1.0更新于 Oct 24, 2026
MCP server exposing Home Assistant REST API functionality
概览
AI 生成的概览
一个本地 MCP 服务器,通过 Home Assistant 的 REST API 让助手查看并控制智能家居实体、服务、事件和日历
- 可以做什么
- 检查 API 状态、配置、已加载组件、事件类型和按域列出的可用服务,读取全部实体状态或单个实体状态,并以资源形式提供当前配置、状态、服务和组件。创建、更新或删除实体状态,触发自定义事件并调用 Home Assistant 服务。渲染 Jinja 模板并处理意图。获取历史状态变更、日志簿条目、错误日志以及日历实体和事件。校验配置文件。
- 适用场景
- 适合在桌面上让助手查询或控制 Home Assistant 智能家居环境,例如读取传感器状态、查看历史与日志,或触发服务和事件。
- 运行要求
- 作为本地 Python 进程运行,从 PyPI 安装(pip install mcp-homeassistant)。需要通过环境变量 HA_URL 提供可访问的 Home Assistant 地址(默认 HA_TOKEN 中提供长期访问令牌(必填)。需要能访问该 Home Assistant 实例的网络。
安装前请注意
HA_TOKEN 长期访问令牌是权限很大的凭据,可访问 Home Assistant API,应妥善保密。多个工具会写入或更改数据:set_state 和 delete_state 修改实体状态,fire_event 发出事件,call_service 可能触发真实设备动作,如门锁、供暖或警报。让助手执行前请先确认这些操作。
安装
在 SourceWeft 中
- 打开 控制台中的 Mcp Homeassistant,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
mcp-homeassistant
MCP server exposing Home Assistant 2026.4.1 REST API functionality.
mcp-name: io.github.daedalus/mcp-homeassistant
Install
Configuration
Set the following environment variables:
HA_URL: Home Assistant URL (default: http://localhost:8123)HA_TOKEN: Long-Lived Access Token (required)
Usage
Tools
The MCP server exposes the following tools:
get_api_status- Check if the API is runningget_config- Get HA configurationget_components- List loaded componentsget_events- List event types and listener countsget_services- List available services by domainget_states- Get all entity statesget_state- Get a specific entity stateset_state- Update or create an entity statedelete_state- Delete an entity statefire_event- Fire a custom eventcall_service- Call a Home Assistant servicerender_template- Render a Jinja templateget_history- Get historical state changesget_logbook- Get logbook entriescheck_config- Validate configuration.yamlhandle_intent- Handle an intentget_error_log- Get error logget_calendars- List calendar entitiesget_calendar_events- Get calendar events
Resources
homeassistant://config- Current confighomeassistant://states- All entity stateshomeassistant://services- Available serviceshomeassistant://components- Loaded components
Development
来源:README.md,提交 330dcaf
工具
0SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。
版本历史
1- v0.1.0最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分