AI导哈

智能家居控制服务

一个用于控制智能家居设备并获取实体状态的Model Context Protocol (MCP)服务器，可与Home Assistant集成，提供安全且可控的API访问。

  • by alexandresanlim
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 alexandresanlim/home-assistant-switch-mcp-server

使用说明

🚀 家庭助理MCP服务器

一种模型上下文协议（MCP）服务器，提供家庭助理集成，用于控制智能家居设备和获取实体状态。将此服务器用作MCP兼容客户端（如Claude、Cursor和其他客户端）中的工具提供者，以与您的家庭助理实例进行交互。这是一个非官方的存储库。

此MCP服务器的主要动机之一是 安全与控制。该服务器提供了一套精心策划的特定工具，您可以安全地与人工智能助手共享，而不是公开整个Home Assistant REST API（包括数百个端点和完整的系统访问）。

🏠 家庭助理切换工具

示例用法：

https://github.com/user-attachments/assets/e7061d6a-faac-4d62-8a73-1449e7d156af

🤖 What is MCP?

模型上下文协议（MCP） 是工具提供商通过标准输入/输出与AI客户端通信的标准。此服务器允许您将家庭助理工具插入任何兼容MCP的客户端。

⚡ 快速入门：在MCP客户端中使用

您可以将此服务器配置为MCP客户端中的工具提供者，如Claude、Cursor、VsCode等：

"home-assistant-mcp-server-switch-local": {
  "command": "npx",
  "args": [
    "@sanlim/home-assistant-mcp-server"
  ],
  "env": {
    "HOME_ASSISTANT_URL": "your_host:8123",
    "HOME_ASSISTANT_TOKEN": "your_long_lived_access_token_here"
  }
}

🛠️ 使用本地构建

  1. 克隆此存储库：
git clone https://github.com/alexandresanlim/home-assistant-switch-mcp-server.git
  1. 安装和构建：
npm install
npm run build
npm run server
  1. 配置您的MCP客户端：
"home-assistant-mcp-server-debug": {
  "command": "node",
  "args": [
    "...replace_to_path_of_project/home-assistant-switch-mcp-server/build/main.js"
  ],
  "env": {
    "HOME_ASSISTANT_URL": "http:/localhost:8123",
    "HOME_ASSISTANT_TOKEN": "your_long_lived_access_token_here"
  }
}

服务器将启动并通过标准输入/输出监听MCP请求。 🎉

🔧 配置

环境变量

  • HOME_ASSISTANT_URL：您的家庭助理实例URL（默认值： http://localhost:8123)
  • HOME_ASSISTANT_TOKEN：您的家庭助理长期访问令牌

获取家庭助理令牌

  1. 登录您的家庭助理前端
  2. 转到您的个人资料： http://YOUR_HA_URL/profile
  3. 向下滚动到“长期访问令牌”
  4. 创建新令牌并复制它

📚 参考和故障排除

  • API完整参考： Home Assistant REST API文档
  • 如果您有问题，请确保您的构建是最新的，并且您的MCP客户端配置为使用stdio。
  • 对于问题或贡献，请随时打开问题或拉取请求！

由以下材料制成❤️ 一位家庭助理爱好者。享受！

相关 MCP