Hekmon8 Homeassistant Server MCP

🚀 家庭助手 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 發佈。