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。
• 对于问题或贡献，请随时打开问题或拉取请求！

______________________________________________________________________

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