Ha MCP Server

🚀 家庭助手 MCP 服務器

家庭助手 MCP 服務器提供了基於 SSE 的實用工具，可用於檢查和優化您的自動化、腳本、情景以及輔助工具，助力您更高效地管理家庭相關設置。

🚀 快速開始

家庭助手 MCP 服務器能幫助您輕鬆檢查和優化家庭自動化等相關設置。以下是啟動服務器的步驟：

1. 克隆倉庫並進入該目錄
2. 複製 .env.example 到 .env 並填寫值
3. 執行 npm install
4. 執行 npm run build
5. 執行 npm start

服務器將在 http://localhost:${PORT}/sse（默認 8080）運行。使用 X-API-Key 標頭進行身份驗證。

✨ 主要特性

• SSE 運輸：帶有 API 密鑰身份驗證，保障數據傳輸安全。
• 豐富工具：提供 get_automations、get_scripts、get_scenes、get_helpers 等工具，方便您獲取各類信息。
• 智能優化：通過 recommend_optimizations 進行優化，可基於獲取的數據提供簡單推薦。

📦 安裝指南

1. 克隆項目倉庫並進入項目目錄：

git clone <倉庫地址>
cd <項目目錄>

2. 複製 .env.example 文件到 .env，並根據實際情況填寫相關值：

cp .env.example .env

3. 安裝項目依賴：

npm install

4. 構建項目：

npm run build

5. 啟動服務器：

npm start

啟動後，服務器將在 http://localhost:${PORT}/sse（默認 8080）運行。請使用 X-API-Key 標頭進行身份驗證。

💻 使用示例

基礎用法

以下是使用不同工具的示例：

// 獲取所有自動化
const getAutomations = async () => {
  const response = await fetch('http://localhost:8080/sse/get_automations', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
};

// 獲取所有腳本
const getScripts = async () => {
  const response = await fetch('http://localhost:8080/sse/get_scripts', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
};

// 獲取所有情景
const getScenes = async () => {
  const response = await fetch('http://localhost:8080/sse/get_scenes', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
};

// 獲取所有輔助工具
const getHelpers = async () => {
  const response = await fetch('http://localhost:8080/sse/get_helpers', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
};

// 進行優化推薦
const recommendOptimizations = async () => {
  const response = await fetch('http://localhost:8080/sse/recommend_optimizations', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
};

// 調用示例
getAutomations();

高級用法

在實際應用中，您可以結合多個工具進行復雜的操作，例如先獲取所有自動化信息，再根據這些信息進行優化推薦：

const complexUsage = async () => {
  const automationsResponse = await fetch('http://localhost:8080/sse/get_automations', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const automations = await automationsResponse.json();

  // 假設我們對獲取的自動化信息進行一些處理後再進行優化推薦
  const processedAutomations = automations.filter(automation => automation.enabled);

  const optimizationResponse = await fetch('http://localhost:8080/sse/recommend_optimizations', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(processedAutomations)
  });
  const optimizationResult = await optimizationResponse.json();
  console.log(optimizationResult);
};

complexUsage();

📚 詳細文檔

工具詳情

• get_automations：列出所有自動化。
• get_scripts：列出所有腳本。
• get_scenes：列出所有情景。
• get_helpers：列出所有輔助工具。
• recommend_optimizations：基於獲取的數據提供簡單推薦。

📄 許可證

本項目採用 MIT License 進行許可。