Openhab MCP

🚀 OpenHAB MCP サーバー

このプロジェクトは、実際の openHAB インスタンスとやり取りする MCP（モデルコンテキストプロトコル）サーバーを提供します。Claude や Cline などの AI アシスタントが openHAB スマートホームシステムとやり取りできるようになります。

🚀 クイックスタート

OpenHAB MCP サーバーは、REST API を通じて実際の openHAB インスタンスに接続する MCP サーバーの実装です。これにより、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 との統合

この MCP サーバーを Claude または Cline で使用するには、以下の手順で設定します。

Claude の場合

1. config.json ファイルに MCP サーバーのアドレスを追加します：

   {
     "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