🚀 家庭助手 MCP 服务器

这是一个用于与 Home Assistant 交互的 Model Context Protocol (MCP) 服务器。借助该服务器，您可以通过支持 MCP 的应用程序，轻松控制和监控家庭设备。

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

🚀 快速开始

本服务器可帮助您通过 MCP 协议与 Home Assistant 进行交互，实现家庭设备的控制与监控。

✨ 主要特性

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

📦 安装指南

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"  // 可选，按领域过滤
  }
});

📚 详细文档

技术栈

本项目使用以下技术和工具：

• Node.js 和 npm 用于构建服务器
• 依赖项管理
• 构建系统

贡献方式

欢迎贡献！您可以按照以下步骤进行：

1. 叉克隆仓库
2. 创建功能分支（git checkout -b feature/your-feature-name）
3. 提交更改并创建拉取请求

请确保在提交前检查代码格式并编写单元测试。

支持与反馈

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

1. 检查仓库中的现有问题
2. 如果问题未被报告，请创建新问题
3. 提供尽可能多的上下文以帮助解决问题
4. 访问 www.aimcp.info 以获取更多支持资源

🔧 技术细节

该项目使用 Node.js 和 npm 构建服务器，通过 package.json 管理依赖和构建脚本。借助 MCP 协议与 Home Assistant 进行交互，实现家庭设备的控制和监控功能。

📄 许可证

该项目根据 MIT License 发布。