Home Assistant MCP Server

“Home Assistant” MCP Server làm được gì?

Home Assistant MCP Server (hass-mcp) là một máy chủ Model Context Protocol (MCP) liên kết các trợ lý AI—như Claude và các LLM khác—với hệ sinh thái Home Assistant của bạn. Bằng cách mở rộng dữ liệu và chức năng của Home Assistant qua chuẩn MCP, nó cho phép các tác nhân AI tương tác, truy vấn và điều khiển thiết bị nhà thông minh cũng như các tự động hóa. Những tác vụ phổ biến mà hass-mcp hỗ trợ bao gồm truy vấn trạng thái thiết bị và cảm biến, bật/tắt đèn hoặc công tắc, tóm tắt trạng thái nhà, khắc phục sự cố tự động hóa, tìm kiếm thực thể cụ thể và hỗ trợ hội thoại hướng dẫn cho các hoạt động thông minh thường gặp. Tích hợp này nâng cao trải nghiệm lập trình viên và người dùng nhờ khả năng quản lý nhà thông minh qua AI hội thoại, tự động hóa và các tác nhân LLM.

Danh sách Prompt

• Không tìm thấy mẫu prompt nào được ghi lại trong kho mã.

Sẵn sàng phát triển doanh nghiệp của bạn?

Bắt đầu dùng thử miễn phí ngay hôm nay và xem kết quả trong vài ngày.

Yêu cầu demo Đăng nhập

Danh sách Resource

• Không có resource MCP nào được liệt kê rõ ràng trong kho mã.

Danh sách Công cụ

• Truy vấn trạng thái thiết bị và cảm biến: Cho phép LLM lấy trạng thái hiện tại của các thực thể Home Assistant.
• Điều khiển đèn, công tắc và các thực thể khác: Hỗ trợ điều khiển trực tiếp (bật/tắt, điều chỉnh độ sáng, v.v.) cho các thành phần nhà thông minh tương thích.
• Nhận tóm tắt tổng quan nhà thông minh: Cung cấp thông tin tổng hợp hoặc cái nhìn tổng thể về trạng thái hiện tại của ngôi nhà.
• Khắc phục sự cố tự động hóa và thực thể: Cung cấp thông tin chẩn đoán hoặc các bước xử lý cho các vấn đề liên quan đến tự động hóa hoặc thực thể thiết bị.
• Tìm kiếm các thực thể cụ thể: Cho phép người dùng hoặc tác nhân tìm thiết bị hoặc cảm biến theo tên hoặc loại trong Home Assistant.
• Hỗ trợ hội thoại hướng dẫn cho các tác vụ phổ biến: Hỗ trợ các tương tác có cấu trúc để hướng dẫn người dùng thực hiện các thao tác nhà thông minh hay dùng.

Tham gia bản tin của chúng tôi

Nhận các mẹo, xu hướng và ưu đãi mới nhất miễn phí.

Địa chỉ email

Đăng ký

Các trường hợp sử dụng của máy chủ MCP này

• Truy vấn trạng thái thiết bị: Lập trình viên và người dùng có thể yêu cầu trạng thái hiện tại một cách lập trình hoặc hội thoại (ví dụ: “Cửa sổ bếp đang mở chứ?”), hỗ trợ giám sát và logic tự động hóa.
• Điều khiển nhà thông minh: Cho phép trợ lý thoại hoặc chatbot bật/tắt đèn, điều chỉnh nhiệt độ, điều khiển thiết bị, nâng cao khả năng tiếp cận và tự động hóa.
• Báo cáo tổng quan trạng thái nhà: LLM có thể tạo báo cáo tổng hợp hàng ngày hoặc theo yêu cầu (ví dụ: “Tối nay nhà tôi thế nào?”) giúp tiện lợi cho người dùng hoặc tích hợp vào dashboard.
• Khắc phục sự cố tự động hóa: Lập trình viên có thể tận dụng máy chủ MCP để xác định lỗi cấu hình hoặc sự cố trong tự động hóa, giúp quá trình gỡ lỗi thuận tiện hơn.
• Tìm kiếm thực thể & hướng dẫn thao tác: Nhanh chóng tìm thiết bị hoặc hướng dẫn người dùng qua các quy trình nhiều bước (ví dụ: “Thiết lập quy trình buổi sáng”) giúp quản lý nhà thông minh dễ dàng hơn.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài đặt Python và Docker trên hệ thống của bạn.
2. Clone kho hass-mcp và cấu hình kết nối Home Assistant trong tệp .env (xem .env.example).
3. Trong Windsurf, mở phần Máy chủ MCP trong cài đặt.
4. Thêm máy chủ hass-mcp bằng cấu hình JSON như sau:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. Lưu cài đặt và khởi động lại Windsurf. Xác minh máy chủ xuất hiện trong danh sách MCP.

Claude

1. Triển khai máy chủ hass-mcp tại máy cục bộ hoặc trên máy chủ mà Claude có thể truy cập.
2. Bảo vệ khóa API Home Assistant của bạn bằng biến môi trường.
3. Trong cấu hình của Claude, thêm mục máy chủ MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Khởi động lại Claude và kiểm tra sự sẵn sàng của máy chủ MCP.
5. Sử dụng biến môi trường để bảo vệ dữ liệu nhạy cảm (xem bên dưới).

Cursor

1. Triển khai hass-mcp và đảm bảo kết nối mạng giữa Cursor và máy chủ MCP.
2. Cấu hình Cursor để sử dụng máy chủ MCP:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. Lưu cấu hình và khởi động lại Cursor.
4. Đặt biến môi trường cho các khóa API khi cần thiết.

Cline

1. Cài đặt các phụ thuộc và chạy máy chủ hass-mcp (xem chi tiết trong kho mã).
2. Trong Cline, mở tệp cấu hình MCP của bạn.
3. Thêm máy chủ hass-mcp:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Khởi động lại Cline để kích hoạt máy chủ MCP mới.

Bảo mật khóa API (mọi nền tảng):

Sử dụng biến môi trường trong cấu hình để bảo vệ thông tin nhạy cảm:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

Cách sử dụng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào luồng làm việc FlowHunt, hãy thêm thành phần MCP vào flow và kết nối với tác nhân AI của bạn:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, thêm thông tin máy chủ MCP của bạn theo định dạng JSON:

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Hãy nhớ thay “hass-mcp” bằng tên thực tế của máy chủ MCP của bạn và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Dựa trên tài liệu và nội dung kho mã hiện có, hass-mcp cung cấp nền tảng vững chắc để tích hợp Home Assistant qua MCP, với các công cụ rõ ràng và hướng dẫn cài đặt/bảo mật hợp lý. Tuy nhiên, chưa có tài liệu về mẫu prompt, định nghĩa resource, hay các tính năng sampling/roots nâng cao trong tài liệu công khai. Tôi đánh giá máy chủ MCP này 6/10: đầy đủ chức năng, thân thiện với lập trình viên nhưng còn thiếu tài liệu mở rộng và các tính năng MCP nâng cao.

Điểm MCP