Openhab MCP

🚀 OpenHAB MCP 服務器

OpenHAB MCP 服務器是一個與實際 openHAB 實例交互的 MCP（模型上下文協議）服務器，它藉助 REST API 連接真實的 openHAB 實例，讓 Claude 和 Cline 等 AI 助手能夠與您的 openHAB 智能家居系統進行交互。

✨ 主要特性

物品管理

1. list_items - 列出所有 openHAB 物品，可選擇按標籤過濾
2. get_item - 通過名稱獲取特定的 openHAB 物品
3. create_item - 創建新的 openHAB 物品
4. update_item - 更新現有的 openHAB 物品
5. delete_item - 刪除 openHAB 物品
6. update_item_state - 僅更新 openHAB 物品的狀態

設備管理

7. list_things - 列出所有 openHAB 設備
8. get_thing - 通過 UID 獲取特定的 openHAB 設備

規則管理

9. list_rules - 列出所有 openHAB 規則，可選擇按標籤過濾
10. get_rule - 通過 UID 獲取特定的 openHAB 規則
11. create_rule - 創建新的 openHAB 規則
12. update_rule - 部分更新現有的 openHAB 規則
13. update_rule_script_action - 更新 openHAB 規則中的腳本操作
14. delete_rule - 刪除 openHAB 規則
15. run_rule_now - 立即執行 openHAB 規則

腳本管理

16. list_scripts - 列出所有 openHAB 腳本（標記為 'Script' 且無觸發器的規則）
17. get_script - 通過 ID 獲取特定的 openHAB 腳本
18. create_script - 創建新的 openHAB 腳本
19. update_script - 更新現有的 openHAB 腳本
20. delete_script - 刪除 openHAB 腳本

📦 安裝指南

環境要求

• Python 3.8 或更高版本

安裝步驟

1. 克隆此倉庫到本地：

   git clone https://github.com/yourusername/openhab-mcp-server.git
   cd openhab-mcp-server
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 配置環境變量或修改配置文件，設置 OpenHAB 服務器的 URL 和 API 密鑰。
4. 運行服務器：

   python server.py
   

與 Claude 和 Cline 集成

要在 Claude 或 Cline 中使用此 MCP 服務器，請按照以下步驟進行配置：

對於 Claude

1. 將 MCP 服務器的地址添加到 config.json 文件中：

   {
     "mcp_url": "http://localhost:8080"
   }
   

2. 在您的技能中導入 MCP 工具模塊：

   from mcp_tools import *
   

對於 Cline

1. 更新 config.yaml 文件，添加 MCP 服務器的配置：

   mcp_server:
     url: http://localhost:8080
   

2. 在您的腳本中導入 MCP 工具模塊：

   from mcp_tools import *
   

示例問題

要測試連接，可以向 Claude/Cline 提問：

你能列出我 OpenHAB 系統中的所有物品嗎？

如果配置正確，Claude/Cline 將使用 MCP 服務器獲取並顯示您的 OpenHAB 物品。

📚 詳細文檔

對於開發，請參考 DEVELOPER.md 文件瞭解基於 Docker 的開發工作流。

⚠️ 注意事項

此實現通過 REST API 連接到實際的 openHAB 實例。為了生產環境使用，建議增強以下功能：

1. 更全面的錯誤處理和日誌記錄
2. 額外的身份驗證和安全功能
3. 更復雜的緩存機制
4. 對更多 openHAB 功能（規則、設備等）的支持

📄 許可證

本項目採用 MIT 許可證。