MCP Blinds

🚀 MCP百葉窗控制器

本項目藉助模型上下文協議（MCP），通過Bond Bridge API實現對電動百葉窗的控制，為用戶提供便捷的百葉窗操控體驗。

✨ 主要特性

• 可控制百葉窗的開啟、關閉或停止動作。
• 支持按名稱、位置或排數對百葉窗進行篩選。
• 集成了異步HTTP API。
• 配備MCP服務器，便於與AI助手集成。

📦 安裝指南

1. 安裝依賴項：

pip install aiohttp mcp

2. 設置環境變量：

export MY_TOKEN="your_bond_token"
export MY_IP="192.168.x.x"

3. 在data/devices.json中配置設備：

[
  {
    "id": "device_id",
    "name": "front",
    "location": "foyer", 
    "row": "top"
  }
]

💻 使用示例

基礎用法

作為MCP服務器運行

python blinds.py

直接調用函數

from blinds import set_blinds_state

# 打開所有百葉窗
await set_blinds_state("Open")

# 關閉辦公室的百葉窗
await set_blinds_state("Close", blind_location="office")

📚 詳細文檔

set_blinds_state(action, blind_name="all", blind_location="all", blind_row="all")

參數說明：

• action：可選值為 "Open"（打開）、"Close"（關閉）或 "Hold"（停止）。
• blind_name：可選值為 "all"（所有）、"front"（前部）、"sunrise"（日出側）、"sunset"（日落側）。
• blind_location：可選值為 "all"（所有）、"foyer"（門廳）、"office"（辦公室）。
• blind_row：可選值為 "all"（所有）、"top"（頂部）、"bottom"（底部）。

🧪 測試

運行測試命令：

pytest test_blinds.py -v