Bond MCP Server

🚀 Bond MCP Server

Bond MCP Serverは、Bond Bridge スマートホームデバイスを制御するためのツールを提供するModel Context Protocol (MCP) サーバーです。このサーバーにより、ClaudeのようなAIアシスタントがBond Bridgeハブを介して、天井扇、暖炉、日よけ、照明などのRF制御デバイスとやり取りできるようになります。

✨ 主な機能

• デバイス管理：接続されているすべてのBondデバイスを一覧表示し、情報を取得します。
• 扇風機制御：天井扇の速度、回転方向、電源状態を制御します。
• 日よけ制御：電動日よけの開閉と位置設定を行います。
• 照明制御：調光可能な照明とその明るさレベルを制御します。
• カスタムアクション：任意のBond APIアクションをデバイスに送信します。
• ブリッジ情報：Bond Bridgeのステータスと設定を取得します。

🚀 クイックスタート

前提条件

• ローカルネットワーク上にBond Bridgeが必要です。
• Bond APIトークン（Bond Homeアプリから取得）が必要です。

Bondトークンの取得方法

1. モバイルデバイスでBond Homeアプリを開きます。
2. 設定 → Bond Bridge → 詳細設定 → APIに移動します。
3. ローカルトークン（クラウドトークンではない）をコピーします。

MCP設定に追加する:

{
  "mcpServers": {
    "bond": {
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "-e", "BOND_TOKEN=your_token_here",
        "-e", "BOND_HOST=192.168.1.100",
        "quay.io/madorn/bond-mcp-server:latest"
      ]
    }
  }
}

📦 インストール

1. 仮想環境の作成とアクティブ化:

   python3 -m venv bond-mcp-env
   source bond-mcp-env/bin/activate  # Windowsの場合: bond-mcp-env\Scripts\activate
   

2. 依存関係のインストール:

   pip install -r requirements.txt
   

3. 環境の設定:

   cp .env.example .env
   # .envをBond Bridgeの設定で編集します
   

4. サーバーの起動:

   python -m bond_mcp.server
   

設定

Bond Bridgeの設定を記載した .env ファイルを作成します。

# 必須: Bond Bridgeの設定
BOND_TOKEN=your_bond_api_token_here
BOND_HOST=192.168.1.100

# オプション: 接続設定
BOND_TIMEOUT=10.0
BOND_MAX_RETRIES=3
BOND_RETRY_DELAY=1.0

# オプション: ログ設定
LOG_LEVEL=INFO

💻 使用例

基本的な使用法

利用可能なツール

デバイス管理

• list_devices() - すべてのBondデバイスを一覧表示します。
• get_device_info(device_id) - デバイスの詳細情報を取得します。
• get_device_state(device_id) - デバイスの現在の状態を取得します。
• get_bridge_info() - Bond Bridgeの情報を取得します。

デバイス制御

• toggle_device_power(device_id) - デバイスの電源をオン/オフ切り替えます。
• send_custom_action(device_id, action, argument?) - カスタムのBondアクションを送信します。

扇風機制御

• set_fan_speed(device_id, speed) - 扇風機の速度を設定します（0 - 8）。
• set_fan_direction(device_id, direction) - 回転方向を設定します（"forward"/"reverse"）。

日よけ制御

• control_shades(device_id, action, position?) - 日よけを制御します。
  • アクション: "open", "close", "set_position"
  • 位置: 0 - 100（set_positionアクションの場合）

照明制御

• set_light_brightness(device_id, brightness) - 照明の明るさを設定します（0 - 100）。

Bond APIリファレンス

このサーバーはBond Local API v2を使用しています。

• ベースURL: http://{bridge_ip}/v2/
• 認証: AuthorizationヘッダーにBearerトークンを使用します。
• ドキュメント: Bond Local API Documentation

📚 ドキュメント

トラブルシューティング

一般的な問題

1. 接続拒否：Bond BridgeのIPが正しく、アクセス可能であることを確認してください。
2. 認証失敗：Bondトークンが正しいことを確認してください（クラウドトークンではなく、ローカルトークンを使用してください）。
3. デバイスが見つからない：list_devices() を使用してデバイスIDが存在することを確認してください。
4. アクションがサポートされていない：get_device_info() を使用してデバイスがアクションをサポートしていることを確認してください。

デバッグログ

環境変数で LOG_LEVEL=DEBUG を設定することで、デバッグログを有効にできます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。