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