Fibaro MCP Server

🚀 Fibaro HC3 MCP Server

Claude AIを通じてFibaro Home Center 3を制御するためのMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このFibaro HC3 MCPサーバーは、Claude AIを通じてFibaro Home Center 3を制御するためのMCP（Model Context Protocol）サーバーです。

⚠️ 重要提示

これはFibaro HC3 MCPサーバーのデモ/教育用バージョンです。これは商用製品ではなく、学習とテスト目的のみでそのまま提供されています。自己責任で使用してください。

✨ 主な機能

• 自動接続 - 起動時にFibaro HC3に自動接続（一度の設定で）
• デバイス、シーン、部屋に関する情報を取得
• デバイスを制御（オン/オフ、値の設定、明るさ、色の設定）
• シーンの実行と停止
• 自然言語制御のためのClaude AIとの完全統合
• 色名マッピングによるRGBライトのサポート
• HTTP/HTTPSプロトコルのサポート

📦 インストール

🚀 クイックインストール (推奨)

1コマンドでのインストール - リポジトリをクローンする必要はありません。

curl -sSL https://raw.githubusercontent.com/kaeljune/fibaro-mcp-server/main/quick-install.sh | bash

このスクリプトは以下を行います。

• ✅ 依存関係（git、node.js、npm）をチェック
• ✅ AIクライアント（Claude DesktopまたはCursor）を選択
• ✅ 自動的にリポジトリをクローン
• ✅ Fibaro HC3の接続詳細を尋ねる
• ✅ 接続をテスト
• ✅ 依存関係をインストールし、プロジェクトをビルド
• ✅ AIクライアントを自動的に設定
• ✅ 使用可能になります！

📋 手動インストール

手動でインストールする場合は、以下の手順を実行します。

1. このリポジトリをクローンします。

git clone https://github.com/kaeljune/fibaro-mcp-server.git
cd fibaro-mcp-server

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

4. 設定スクリプトを実行します。

./install-claude.sh

💻 使用例

インストール後、手動での接続は必要ありません。MCPサーバーは、AIクライアント（Claude DesktopまたはCursor）が起動すると自動的にFibaro HC3に接続します。

サポートされるAIクライアント

• Claude Desktop - 完全なMCPサポート
• Cursor - AIによるコーディングのためのMCP統合

1. デバイスリストを表示

Show all devices

2. ライトを制御

Turn off light number 3

Turn on living room light

Set light number 5 brightness to 50%

3. RGBライトを制御

Change RGB light number 10 to red

Set RGB light number 10 to purple (255,0,255,0)

4. シーンを実行

Run scene "Good Night"

📚 ドキュメント

利用可能なコマンド

情報取得

• fibaro_get_devices：すべてのデバイスのリストを取得
• fibaro_get_device：IDでデバイスの詳細情報を取得
• fibaro_get_scenes：すべてのシーンのリストを取得
• fibaro_get_scene：IDでシーンの詳細情報を取得
• fibaro_get_rooms：すべての部屋のリストを取得

制御

• fibaro_turn_on_device：IDでデバイスをオンにする
• fibaro_turn_off_device：IDでデバイスをオフにする
• fibaro_set_device_value：デバイスのプロパティ値を設定
• fibaro_set_brightness：ライト/調光器の明るさを設定（0-100%）
• fibaro_set_color：RGBライトのRGB色を設定（R,G,B,W: 0-255）
• fibaro_control_rgb_light：RGBライトの完全制御（オン/オフ + 色 + 明るさ）
• fibaro_run_scene：IDでシーンを実行
• fibaro_stop_scene：IDでシーンを停止

統合例

設定後、Claudeに以下のように話しかけることができます。

• "Turn off all lights in the house"
• "Turn on bedroom light"
• "Run good morning scene"
• "Show status of all sensors"
• "Set living room light brightness to 50%"
• "Change living room RGB light to green"
• "Set RGB light number 5 to light purple"

Claudeは自動的に以下のことを行います。

1. Fibaro HC3に接続（まだ接続されていない場合）
2. 一致するデバイス/シーンを見つける
3. 制御コマンドを実行
4. 結果を報告

🔧 技術詳細

セキュリティ

• このサーバーはローカルでのみFibaro HC3に接続します。
• ログイン資格情報はMCP設定に安全に保存されます。
• 自己署名証明書を受け入れるHTTPとHTTPSの両方をサポートします。
• ログには機密情報は保存されません。

トラブルシューティング

Fibaro HC3に接続できない場合

• インストールスクリプトを再実行します：./install-claude.sh
• IPアドレスとポートを確認します（デフォルトHTTP: 80、HTTPS: 443）
• ユーザー名/パスワードが正しいことを確認します
• ファイアウォールとネットワーク接続を確認します
• ブラウザからHC3のWebインターフェイスにアクセスしてみます

MCPサーバーが動作しない場合

• Claude設定のパスを確認します
• プロジェクトがビルドされていることを確認します（npm run build）
• 設定を変更した後、Claude Desktopを再起動します
• Claude Desktopのログを確認して詳細なエラーメッセージを取得します

Fibaro HC3の接続情報を変更する場合

IP、ユーザー名、またはパスワードを変更するには、以下の手順を実行します。

1. インストールスクリプトを再実行します：./install-claude.sh
2. 新しい情報を入力します
3. Claude Desktopを再起動します

📄 ライセンス

これはデモ/教育用プロジェクトです。商用利用はできません。