Home Assistant MCP

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

设置

通过 Smithery 安装

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

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

手动安装

1. 安装依赖项：

npm install

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

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

启动服务器

npm start

用于开发：

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 文件。