AI导哈

智能家居集成协议

Home Assistant MCP是一个模型上下文协议服务器，提供与Home Assistant集成的工具，使AI助手能够与智能家居设备交互。

  • by guilhermelirio
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 guilhermelirio/homeassistant-mpc

使用说明

家庭助理MCP

这是一个MCP（模型上下文协议）服务器，提供与家庭助理集成的工具，允许人工智能助理与智能家居设备进行交互。

设置

通过Smithery安装

通过以下方式自动安装Claude Desktop的家庭助理集成 史密瑟里:

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

手动安装

  1. 安装依赖项：
npm install
  1. 配置环境变量：
    • 从您的家庭助理获取长期访问令牌
    • 在中配置环境变量 .env 项目根目录下的文件：
HOME_ASSISTANT_URL=http://your-home-assistant:8123
HOME_ASSISTANT_TOKEN=your_token_here

启动服务器

npm start

发展：

npm run dev

可用工具

首页助理API验证

  • 家庭助理_ api：验证Home Assistant API是否联机
    • 参数：无
    • 例子： homeassistant_api()

获取实体状态

  • 家庭助理_get_state：获取家庭助理实体的当前状态
    • 参数： entity_id （实体ID）
    • 例子： homeassistant_get_state("light.living_room")

呼叫服务

  • 家庭助理_呼叫服务：呼叫家庭助理实体的服务
    • 参数：
      • 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

贡献

欢迎投稿！请随时打开问题或提交pull请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP