Homeassistant Server MCP

🚀 家庭助手 MCP 服務器

家庭助手 MCP 服務器是一個用於與家庭助手交互的模型上下文協議（MCP）服務器。它提供了一系列工具，可通過支持 MCP 的應用控制和監控您的家庭助手設備，為智能家居管理帶來便利。

該項目是 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 設置文件中添加以下內容來配置服務器（通常位於 ~/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 替換為您的家庭助手實例 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: "your_automation_id"
  }
});

4. 列出可用實體

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {}
});

🔧 技術細節

為了安全使用此服務器，請遵循以下安全建議：

1. 始終使用 HTTPS 對您的家庭助手實例。
2. 保護訪問令牌的安全，絕不在版本控制中提交。
3. 定期輪換訪問令牌。
4. 使用環境變量存儲敏感信息。

📚 詳細文檔

如果您遇到任何問題或有疑問，請按以下步驟操作：

1. 檢查倉庫中現有的問題。
2. 如果您的問題尚未報告，請創建新問題。
3. 提供儘可能多的上下文當報告問題時。
4. 訪問 www.aimcp.info 以獲取更多支持資源。