Home Assistant MCP

这是一个MCP（Model Context Protocol）服务器，提供了与Home Assistant集成的工具，使AI助手能够与智能家居设备进行交互。

设置

通过Smithery安装

要通过Smithery自动安装适用于Claude Desktop的Home Assistant集成：

bash npx -y @smithery/cli install @guilhermelirio/homeassistant-mpc --client claude

手动安装

1. 安装依赖项：

bash npm install

2. 配置环境变量：
   • 从您的Home Assistant获取一个长期访问令牌
   • 在项目根目录下的.env文件中配置环境变量：

HOME_ASSISTANT_URL=http://your-home-assistant:8123 HOME_ASSISTANT_TOKEN=your_token_here

启动服务器

bash npm start

开发模式下：

bash npm run dev

可用工具

Home Assistant API验证

• homeassistant_api: 验证Home Assistant API是否在线
  • 参数：无
  • 示例：homeassistant_api()

获取实体状态

• homeassistant_get_state: 获取Home Assistant实体的当前状态
  • 参数：entity_id (实体ID)
  • 示例：homeassistant_get_state("light.living_room")

调用服务

• homeassistant_call_service: 为Home Assistant实体调用服务
  • 参数：
    • entity_id (实体ID)
    • domain (服务域)
    • service (要调用的服务)
  • 示例：homeassistant_call_service("light.living_room", "light", "turn_on")

开发

此项目使用TypeScript和MCP SDK库来创建可以被诸如Claude、GPT等语言模型访问的工具。

要添加新工具：

1. 在src/tools/[category]中创建一个模块
2. 按照现有模式实现您的工具
3. 在src/index.ts中注册该模块

贡献

欢迎贡献！请随时提出问题或提交拉取请求。

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

来源

• 来源：github
• 链接：https://github.com/guilhermelirio/homeassistant-mpc