Mcp Homeassistant

io.github.daedalus由 GitHub 账号 daedalus 发布v0.1.0更新于 Oct 24, 2026

MCP server exposing Home Assistant REST API functionality

已验证STDIO仅桌面位置与生活效率与工作流

概览

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 中

  1. 打开 控制台中的 Mcp Homeassistant,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-homeassistant

MCP server exposing Home Assistant 2026.4.1 REST API functionality.

[PyPI] [Python] [Ruff]

mcp-name: io.github.daedalus/mcp-homeassistant

Install

bash
pip install mcp-homeassistant

Configuration

Set the following environment variables:

  • HA_URL: Home Assistant URL (default: http://localhost:8123)
  • HA_TOKEN: Long-Lived Access Token (required)

Usage

bash
export HA_URL="http://homeassistant:8123"export HA_TOKEN="your_long_lived_access_token"mcp-homeassistant

Tools

The MCP server exposes the following tools:

  • get_api_status - Check if the API is running
  • get_config - Get HA configuration
  • get_components - List loaded components
  • get_events - List event types and listener counts
  • get_services - List available services by domain
  • get_states - Get all entity states
  • get_state - Get a specific entity state
  • set_state - Update or create an entity state
  • delete_state - Delete an entity state
  • fire_event - Fire a custom event
  • call_service - Call a Home Assistant service
  • render_template - Render a Jinja template
  • get_history - Get historical state changes
  • get_logbook - Get logbook entries
  • check_config - Validate configuration.yaml
  • handle_intent - Handle an intent
  • get_error_log - Get error log
  • get_calendars - List calendar entities
  • get_calendar_events - Get calendar events

Resources

  • homeassistant://config - Current config
  • homeassistant://states - All entity states
  • homeassistant://services - Available services
  • homeassistant://components - Loaded components

Development

bash
git clone https://github.com/daedalus/mcp-homeassistant.gitcd mcp-homeassistantpip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

来源:README.md,提交 330dcaf

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分