mcpField
M
mcp-homeassistant

mcp-homeassistant

本地服务
github.com/daedalus其他027 周前更新
代码仓库

关于 mcp-homeassistant

mcp-homeassistant 通过 MCP 服务提供 Home Assistant REST API 操作，可检查配置和状态、调用服务，并访问历史记录与日历。

主要功能

  1. 01查看 API 状态和配置
  2. 02读取及修改实体状态
  3. 03列出服务、事件和组件
  4. 04调用服务并触发事件
  5. 05渲染模板并验证配置
  6. 06访问历史记录、日志和日历

适用场景

  1. 01检查实体状态和可用服务
  2. 02调用 Home Assistant 服务
  3. 03查看状态历史或日历事件

MCP 相关

该 MCP 服务将 Home Assistant REST API 操作作为工具提供，并通过资源公开配置、状态、服务和组件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "daedalus-mcp-homeassistant": {
      "command": "uvx",
      "args": [
        "mcp-homeassistant"
      ]
    }
  }
}
启动命令uvx mcp-homeassistant

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-homeassistant0.1.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-homeassistant

提供 Home Assistant 2026.4.1 REST API 功能的 MCP 服务。

PyPI Python Ruff

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

安装

pip install mcp-homeassistant

配置

设置以下环境变量：

使用

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

工具

MCP 服务提供以下工具：

  • get_api_status - 检查 API 是否正在运行
  • get_config - 获取 HA 配置
  • get_components - 列出已加载的组件
  • get_events - 列出事件类型和监听器数量
  • get_services - 按域列出可用服务
  • get_states - 获取所有实体状态
  • get_state - 获取指定实体状态
  • set_state - 更新或创建实体状态
  • delete_state - 删除实体状态
  • fire_event - 触发自定义事件
  • call_service - 调用 Home Assistant 服务
  • render_template - 渲染 Jinja 模板
  • get_history - 获取历史状态变更
  • get_logbook - 获取日志簿条目
  • check_config - 验证 configuration.yaml
  • handle_intent - 处理意图
  • get_error_log - 获取错误日志
  • get_calendars - 列出日历实体
  • get_calendar_events - 获取日历事件

资源

  • homeassistant://config - 当前配置
  • homeassistant://states - 所有实体状态
  • homeassistant://services - 可用服务
  • homeassistant://components - 已加载的组件

开发

git clone https://github.com/daedalus/mcp-homeassistant.git
cd mcp-homeassistant
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。