Home Assistant MCP 服务器

这是一个用于与 Home Assistant 交互的 Model Context Protocol (MCP) 服务器。此服务器提供了通过 MCP 启用的应用程序控制和监控您的 Home Assistant 设备的工具。

<a href="https://glama.ai/mcp/servers/io8m0yc5wq"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=219928234,4232733022&fm=3081&app=33081&f=PNG?w=760&h=400" alt="Home Assistant Server MCP 服务器" /> </a>

该项目是 AI 模型上下文协议 (MCP) 生态系统的一部分。有关 MCP 工具的更多信息和文档，请访问 www.aimcp.info。

功能

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

安装

1. 克隆此仓库：

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

4. 配置 MCP 服务器，在您的 MCP 设置文件中添加以下内容（通常位于 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 对于 VSCode）：

{
  "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"
      }
    }
  }
}

请将 your-homeassistant-url 和 your-long-lived-access-token 替换为您 Home Assistant 实例的 URL 和访问令牌。

使用方法

该服务器提供以下工具：

1. 获取设备状态

// 示例使用
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

2. 切换设备状态

// 示例使用
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on"  // 或 "off"
  }
});

3. 触发自动化

// 示例使用
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "trigger_automation",
  arguments: {
    automation_id: "automation.morning_routine"
  }
});

4. 列出实体

// 示例使用
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {
    domain: "light"  // 可选，按领域过滤
  }
});

贡献

欢迎贡献！以下是您可以帮助的方式：

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些精彩的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

请确保更新测试并遵循现有的代码风格。

文档

关于 MCP 工具和生态系统的详细文档：

• 访问 www.aimcp.info
• 查看网站上的 MCP 工具目录
• 阅读集成指南和最佳实践

许可证

本项目根据 MIT 许可证授权 - 详情如下：

MIT 许可证

版权所有 (c) 2024 homeassistant-mcp

在此授权任何人免费获得本软件及其相关文档文件（以下简称“软件”），在不受限制的情况下处理软件，包括但不限于以下权利：
使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向其提供软件的人这样做，但需遵守以下条件：

上述版权声明和本许可通知应包含在所有副本或软件的重要部分中。

软件按“原样”提供，不附带任何形式的保证，包括但不限于对适销性、特定用途适用性和非侵权性的默示保证。在任何情况下，作者或版权持有人都不对因软件或软件的使用或其他交易而引起的任何索赔、损害或其他责任负责，无论是合同行为、侵权行为还是其他行为。

安全

为了安全地使用此服务器：

1. 始终使用 HTTPS 对您的 Home Assistant 实例
2. 保护好您的访问令牌，切勿将其提交到版本控制系统
3. 定期轮换您的访问令牌
4. 使用环境变量存储敏感信息

支持

如果您遇到任何问题或有疑问，请：

1. 检查仓库中的现有问题
2. 如果您的问题尚未报告，请创建一个新问题
3. 报告问题时尽可能提供详细背景
4. 访问 www.aimcp.info 获取更多支持资源