Indigo MCP Server

🚀 Indigo MCPサーバープラグイン

Indigo Domotics用のモデルコンテキストプロトコル（MCP）サーバープラグインです。このプラグインにより、ClaudeなどのAIアシスタントが自然言語クエリを通じてホームオートメーションシステムと対話できるようになります。

🚀 クイックスタート

このプラグインは、AIアシスタントとIndigoのホームオートメーションシステムを橋渡しし、デバイス、変数、アクションの検索や操作を可能にします。以下は使用できるクエリの例です。

• "Find all light switches in the bedroom" - 寝室のすべての照明スイッチの詳細なデータを返します。
• "Show me temperature sensors" - すべての温度センサーと環境センサーの完全なプロパティを取得します。
• "Get all dimmers" - 調光可能なデバイスをフィルタリングします。
• "Find motion sensors" - モーションセンサーを検索し、完全なデバイス情報を提供します。
• "Show devices in the basement" - 地下室のデバイスを位置ベースで検索し、完全なデバイスメタデータを表示します。

✨ 主な機能

• AIアシスタントとIndigoホームオートメーションシステムの連携
• 自然言語によるデバイス、変数、アクションの検索と操作
• ベクターデータベースを使用したセマンティック検索機能

📦 インストール

必須項目

• OpenAI APIキー：セマンティック検索機能に必須です。
  • OpenAI PlatformからAPIキーを取得してください。
  • ベクター検索機能を動作させるための埋め込みを生成するために使用されます。
  • ホームオートメーションクエリの場合、コストは通常最小限です。

サポートされるシステム

• Indigo Domotics 2024.2 以上
• Python 3.11+

オプション項目

LangSmith（テストとデバッグ）

• 目的：AI対話の高度なトレーシングとデバッグ
• 利点：クエリのパフォーマンスを監視、検索結果をデバッグ、プロンプトを最適化
• セットアップ：LangSmith APIキーとプロジェクト構成が必要
• ユースケース：開発者または検索問題を経験しているユーザーに推奨

InfluxDB（履歴クエリ）

• 目的：過去のデバイスデータとトレンドにアクセス
• 利点：過去のデバイス状態をクエリ、時間経過に伴う使用パターンを分析
• セットアップ：Indigoの履歴データを持つInfluxDBインスタンスを実行する必要があります。
• ユースケース：既存のInfluxDBロギング設定を持つユーザーに役立ちます。

🔧 技術詳細

なぜベクターストアを使用するのか？

このプラグインはベクターデータベース（LanceDB）を使用してセマンティック検索機能を有効にしています。単純なテキストマッチングではなく、クエリの意味とコンテキストを理解するため、検索がより直感的で強力になります。

📚 ドキュメント

利用可能なMCPリソース

デバイスリソース

• GET /devices - 最小限のプロパティですべてのデバイスをリストします（概要用）。
• GET /devices/{id} - 特定のデバイスの完全なプロパティを取得します。
• GET /devices/by-type/{type} - 論理的なタイプでフィルタリングされたデバイスを取得します。

変数リソース

• GET /variables - すべての変数をリストします。
• GET /variables/{id} - 特定の変数を取得します。

アクションリソース

• GET /actions - すべてのアクショングループをリストします。
• GET /actions/{id} - 特定のアクショングループを取得します。

利用可能なMCPツール

1. search_entities

すべてのIndigoエンティティを対象とした自然言語検索です。

• 目的：デバイス、変数、アクショングループを対象としたセマンティック検索
• 入力：自然言語クエリ（例："bedroom lights", "temperature sensors"）
• 検索機能：
  • 類似度閾値：0.15（この閾値以上のすべての関連結果を返します）
  • 人工的な結果制限なし - すべての一致するエンティティを返します
  • 完全なデバイスプロパティが含まれます（フィルタリングされません）
  • セマンティックキーワードの強化により検索精度が向上します
  • デバイスタイプのフィルタリングがサポートされています（dimmer, relay, sensor, thermostat, sprinkler, io, other）
• 出力：完全なエンティティプロパティと関連性スコア付きのフォーマットされた結果

2. get_devices_by_type

セマンティックフィルタリングなしで特定のタイプのすべてのデバイスを取得します。

• 目的：特定のデバイスタイプに一致するすべてのデバイスを取得する
• 入力：デバイスタイプ（dimmer, relay, sensor, multiio, speedcontrol, sprinkler, thermostat, device）
• 出力：指定されたタイプのすべてのデバイスの完全なプロパティ
• ユースケース：特定のタイプのすべてのデバイスが必要な場合、コンテキスト検索結果ではなく

3. デバイス制御ツール

直接的なデバイス制御機能です。

• device_turn_on - デバイスIDでデバイスをオンにします。
• device_turn_off - デバイスIDでデバイスをオフにします。
• device_set_brightness - 調光可能なデバイスの明るさレベルを設定します（0-1または0-100）。

4. variable_update

Indigoの変数値を更新します。

• 目的：Indigoシステム内の変数値を変更する
• 入力：変数IDと新しい値（文字列として）
• 出力：操作ステータスと更新された変数情報

5. action_execute_group

Indigoのアクショングループ（シーン）を実行します。

• 目的：Indigoシステム内のアクショングループ/シーンをトリガーする
• 入力：アクショングループIDとオプションの遅延時間（秒）
• 出力：実行ステータスと確認

6. analyze_historical_data

LangGraphワークフローを使用したAIパワードの履歴データ分析です。

• 目的：時間経過に伴うデバイスの動作パターンとトレンドを分析する
• 入力：自然言語クエリ、デバイス名のリスト、時間範囲（1-365日、デフォルト：30日）
• 機能：
  • 高度なAIワークフローを使用したデータ分析
  • 洞察とトレンドの特定を提供
  • 複雑なパターン認識クエリをサポート
• 出力：洞察とビジュアライゼーション付きの詳細な分析結果

💻 使用例

MCPクライアントのセットアップ

Claude Desktopの設定

claude_desktop_config.jsonファイルに以下の設定を追加してください。

{
  "mcpServers": {
    "indigo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://[your server]:8080/mcp"
      ]
    }
  }
}

IPアドレスまたはIndigoサーバーのホスト名を置き換え、ポート8080を設定したサーバーポートに置き換えてください（異なる場合）。

Claude Desktopの設定ファイルの場所

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

その他のMCPクライアント

このプラグインは、MCP互換のクライアントと互換性があります。HTTPトランスポートエンドポイントを使用してください。

http://[your server]:[YOUR_PORT]/mcp

テスト済みのクライアント

• ✅ Claude Desktop：完全にテストされ、サポートされています。
• ⚠️ その他のMCPクライアント：動作するはずですが、十分にテストされていません。

📄 ライセンス

ドキュメントにライセンス情報は記載されていません。

⚠️ 重要提示

LLMの使用

• OpenAI API：デバイス名、状態、説明がOpenAIに送信され、埋め込みが生成されます。
• 検索クエリ：自然言語クエリは、セマンティック理解のためにOpenAIによって処理される場合があります。
• 最小限のデータ：送信されるのはデバイス名、タイプ、説明のみで、機密性の高い設定詳細は送信されません。
• ローカルストレージ：すべてのベクター埋め込みはIndigoサーバー上にローカルに保存されます。

HTTPサーバーのセキュリティ

• ローカルのみ：セキュリティ上の理由から、サーバーはデフォルトで127.0.0.1（localhost）にバインドされています。
• リモートアクセスを有効にする場合、インターネットに公開しないでください：このHTTPサーバーをインターネットに公開しないでください。

💡 使用建议

デバイスのメモに情報を追加すると、LLMの結果を改善するのに役立ちます。

将来の予定

予定されている機能

• SSLサポートの追加（複雑になる可能性があります）
• 認証トークンの追加

サポートとトラブルシューティング

問題をここに追加してください。サポートに関する質問は、こちらにアクセスしてください。