Nanoleaf MCP Server

🚀 Nanoleaf MCP Server

Nanoleafスマートライトを制御するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、WarpターミナルまたはMCP互換のクライアントを通じてNanoleafデバイスを制御するツールを提供します。

✨ 主な機能

• 🔍 ネットワーク上のNanoleafデバイスの自動検出
• 🔗 特定のデバイスをターゲットにするための直接IP接続
• 🔐 安全なデバイスペアリングのための認証サポート
• 💡 ライト、明るさ、色、エフェクトの完全制御
• 🐳 簡単なデプロイのためのDocker化
• 🖥️ Warpターミナルとの統合

📦 利用可能なツール

• get_nanoleaf_info - 詳細なデバイス情報を取得
• turn_on_nanoleaf / turn_off_nanoleaf - 電源状態を制御
• set_brightness - 明るさを調整（0 - 100）
• set_color - 色相（0 - 360）と彩度（0 - 100）を使用して色を設定
• set_effect - 照明エフェクトを適用
• get_effects - 利用可能なすべてのエフェクトをリスト表示
• discover_nanoleaf - ネットワーク上のデバイスを検出
• connect_to_ip - 特定のIPアドレスに接続
• authorize_nanoleaf - ペアリングモードのデバイスで認証

🚀 クイックスタート

自動セットアップ（推奨）

最も簡単なセットアップ体験を得るには、同梱のセットアップスクリプトを使用します。

./setup.sh

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

1. Dockerイメージをビルドします。
2. ネットワーク上のNanoleafデバイスをスキャンします。
3. 認証トークンの取得を支援します。
4. すべての設定ファイルを作成します。
5. セットアップをテストします。
6. Warpの設定を生成します。

手動セットアップ

前提条件

• システムにDockerがインストールされていること
• ネットワーク上にNanoleafデバイスが存在すること
• Warpターミナル（MCP統合に必要な場合は任意）

ステップ1: クローンとビルド

git clone <repository-url>
cd nanoleaf-mcp-server
docker build -t nanoleaf-mcp-server-nanoleaf-mcp-server .

ステップ2: Nanoleafデバイスを見つける

オプションA: 自動検出

docker run --rm -i --network=host nanoleaf-mcp-server echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "discover_nanoleaf", "arguments": {}}}'

オプションB: 手動IPスキャン

# Nanoleafポートで応答するデバイスをネットワーク上でスキャン
nmap -p 16021 192.168.1.0/24

オプションC: ルーター管理パネルで接続されているデバイスを確認する

ステップ3: 認証トークンを取得する

1. Nanoleafデバイスをペアリングモードに設定する
   • Nanoleafデバイスの電源ボタンを5 - 7秒間押します。
   • ペアリングインジケーター（通常は点滅するライト）を探します。
2. すぐに（30秒以内に）認証トークンを取得する

# 192.168.1.100をデバイスのIPに置き換える
curl -X POST http://192.168.1.100:16021/api/v1/new

以下のような応答が返されます。

{"auth_token":"YourAuthTokenHere123456789"}

ステップ4: 環境を設定する

プロジェクトディレクトリに.envファイルを作成します。

NANOLEAF_IP=192.168.1.100
NANOLEAF_AUTH_TOKEN=YourAuthTokenHere123456789
NANOLEAF_PORT=16021
NANOLEAF_PROTOCOL=http

ステップ5: セットアップをテストする

# 環境変数を使用してテスト
docker run --rm -i --network=host --env-file .env nanoleaf-mcp-server echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_nanoleaf_info", "arguments": {}}}'

成功すると、Nanoleafデバイスの詳細情報が表示されます。

ステップ6: サンプルを実行する（オプション）

サンプルスクリプトを使用してすべての機能をテストします。

./examples.sh

これにより、ライトのオン/オフ、色の変更、エフェクトの適用など、利用可能なすべての機能が実証されます。

💻 使用例

基本的な使用法

以下は実際の値を使用した完全な動作例です（自分の値に置き換えてください）。

1. 検出されたデバイス: <DEVICE_IP>:16021
2. 取得された認証トークン: <AUTH_TOKEN>
3. Warpの設定:

{
  "mcpServers": {
    "nanoleaf": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-e", "NANOLEAF_IP=<DEVICE_IP>",
        "-e", "NANOLEAF_AUTH_TOKEN=<AUTH_TOKEN>",
        "-e", "NANOLEAF_PORT=16021",
        "-e", "NANOLEAF_PROTOCOL=http",
        "nanoleaf-mcp-server-nanoleaf-mcp-server"
      ],
      "env": {}
    }
  }
}

4. テストコマンド:

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "set_effect", "arguments": {"effect": "Cyberpunk 2077"}}}' | docker run --rm -i --network=host -e NANOLEAF_IP=<DEVICE_IP> -e NANOLEAF_AUTH_TOKEN=<AUTH_TOKEN> nanoleaf-mcp-server-nanoleaf-mcp-server

高度な使用法

Warpターミナルとの統合

Warp MCP設定に追加する

以下をWarp MCPサーバーの設定に追加します（実際のデバイスのIPアドレスと認証トークンに置き換えてください）。

{
  "mcpServers": {
    "nanoleaf": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-e", "NANOLEAF_IP=192.168.1.100",
        "-e", "NANOLEAF_AUTH_TOKEN=YourAuthTokenHere123456789",
        "-e", "NANOLEAF_PORT=16021",
        "-e", "NANOLEAF_PROTOCOL=http",
        "nanoleaf-mcp-server-nanoleaf-mcp-server"
      ],
      "env": {}
    }
  }
}

⚠️ 重要提示

• 192.168.1.100をNanoleafデバイスのIPアドレスに置き換えてください。
• YourAuthTokenHere123456789を実際の認証トークンに置き換えてください。
• nanoleaf-mcp-server-nanoleaf-mcp-serverというタグでDockerイメージをビルドしていることを確認してください。

代替設定（パスの問題が発生した場合）

パス関連の問題が発生した場合は、この代替アプローチを使用することもできます。

{
  "mcpServers": {
    "nanoleaf": {
      "command": "bash",
      "args": ["-c", "cd /path/to/nanoleaf-mcp-server && docker run --rm -i --network=host --env-file .env nanoleaf-mcp-server-nanoleaf-mcp-server"],
      "env": {}
    }
  }
}

Warpでの使用

設定が完了したら、Warp内で直接Nanoleafツールを使用できます。

• ライトのオン/オフを要求する
• 明るさと色を変更する
• "Northern Lights"や"Cyberpunk"などのクールなエフェクトを適用する
• デバイス情報を取得する

手動使用例

ライトのオン/オフ

# オン
curl -X PUT http://your-ip:16021/api/v1/your-token/state \
  -H "Content-Type: application/json" \
  -d '{"on":{"value":true}}'

# オフ
curl -X PUT http://your-ip:16021/api/v1/your-token/state \
  -H "Content-Type: application/json" \
  -d '{"on":{"value":false}}'

明るさの設定

curl -X PUT http://your-ip:16021/api/v1/your-token/state \
  -H "Content-Type: application/json" \
  -d '{"brightness":{"value":50}}'

エフェクトの適用

curl -X PUT http://your-ip:16021/api/v1/your-token/effects \
  -H "Content-Type: application/json" \
  -d '{"select":"Northern Lights"}'

📚 詳細ドキュメント

トラブルシューティング

デバイスが見つからない場合

• デバイスが同じネットワーク上にあることを確認してください。
• ファイアウォールの設定を確認してください。
• 手動IPスキャンを試してみてください: nmap -p 16021 192.168.1.0/24

認証に失敗した場合

• デバイスがペアリングモードにあることを確認してください（電源ボタンを5 - 7秒間押す）。
• ペアリングモードは約30秒しか持続しません。
• 他のデバイスがすでに制御していないことを確認してください。

接続の問題

• IPアドレスが正しいことを確認してください。
• デバイスがHTTPSを使用しているかどうかを確認してください（一部の新しいモデル）。
• Dockerがネットワークアクセスを持っていることを確認してください（--network=host）。

環境変数が機能しない場合

• .envファイルが存在し、正しい値が設定されていることを確認してください。
• Dockerコマンドに--env-file .envが含まれていることを確認してください。
• Warpの設定でファイルパスが絶対パスであることを確認してください。

Warpターミナルの問題

"指定されたパスが見つかりません"エラー

• --env-fileの代わりに直接環境変数を設定してください。
• Dockerイメージのタグが正確に一致していることを確認してください: nanoleaf-mcp-server-nanoleaf-mcp-server。
• パスの問題が解決しない場合は、代替のbash設定を試してみてください。

WarpでMCPサーバーが応答しない場合

• 正しいタグでDockerイメージがビルドされていることを確認してください。
• 設定内のIPアドレスと認証トークンが正しいことを確認してください。
• 最初にDockerコマンドを手動でテストしてみてください。

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_nanoleaf_info", "arguments": {}}}' | docker run --rm -i --network=host -e NANOLEAF_IP=your-ip -e NANOLEAF_AUTH_TOKEN=your-token nanoleaf-mcp-server-nanoleaf-mcp-server

ログに"MCP server exited"が表示される場合

• これは通常、設定の問題を示しています。
• すべての環境変数が正しく設定されていることを確認してください。
• Dockerイメージが存在することを確認してください: docker images | grep nanoleaf。

デバイス互換性

以下のデバイスでテストされています。

• Nanoleaf Canvas
• Nanoleaf Light Panels
• Nanoleaf Hexagons

v1 APIをサポートするほとんどのNanoleafデバイスで動作するはずです。

コントリビューション

問題の報告、機能要求、またはプルリクエストを自由に送信してください！

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。