OpenHAB MCP 服务器

一个与实际 openHAB 实例交互的 MCP（模型上下文协议）服务器。

概述

该项目提供了一个实现的 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