Home Assistant MCP Server

基本能力

产品定位

Home Assistant MCP Server 是一个智能家居控制中间件，作为 Home Assistant 系统与 MCP 生态系统之间的桥梁。

核心功能

• 获取设备状态
• 控制设备开关状态
• 触发自动化场景
• 列出可用实体

适用场景

• 通过 MCP 兼容应用远程控制智能家居设备
• 在自动化流程中集成 Home Assistant 设备控制
• 开发基于 MCP 协议的智能家居应用

工具列表

1. get_state - 获取指定设备的状态
2. toggle_entity - 切换设备开关状态
3. trigger_automation - 触发指定的自动化场景
4. list_entities - 列出所有或特定类型的设备实体

常见问题解答

• 安全建议：始终使用 HTTPS 连接 Home Assistant，妥善保管访问令牌
• 配置问题：确保正确设置 HA_URL 和 HA_TOKEN 环境变量
• 支持渠道：可通过 GitHub 仓库提交问题或访问 aimcp.info 获取支持

使用教程

使用依赖

1. 需要安装 Node.js 环境
2. 需要访问 Home Assistant 实例的权限

安装教程

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp
npm install
npm run build

配置说明

在 MCP 设置文件中添加以下配置（通常位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

调试方式

1. 检查服务是否正常运行
2. 验证环境变量设置是否正确
3. 使用示例工具调用测试功能

示例代码

获取设备状态

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

切换设备状态

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on"
  }
});

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。