MCP Blinds

🚀 MCP Blinds Controller

Control motorized window blinds through Bond Bridge API using Model Context Protocol (MCP).

🚀 Quick Start

This project allows you to control motorized window blinds via the Bond Bridge API using the Model Context Protocol (MCP). Follow the steps below to get started.

✨ Features

• Open, close, or stop blinds movement
• Filter blinds by name, location, or row
• Async HTTP API integration
• MCP server for AI assistant integration

📦 Installation

1. Install dependencies:

pip install aiohttp mcp

2. Set environment variables:

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

3. Configure devices in data/devices.json:

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

💻 Usage Examples

Basic Usage

As MCP Server

python blinds.py

Direct Function Call

from blinds import set_blinds_state

# Open all blinds
await set_blinds_state("Open")

# Close office blinds
await set_blinds_state("Close", blind_location="office")

📚 Documentation

API Reference

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

Parameters:

• action: "Open", "Close", or "Hold"
• blind_name: "all", "front", "sunrise", "sunset"
• blind_location: "all", "foyer", "office"
• blind_row: "all", "top", "bottom"

🔧 Technical Details

Testing

Run tests:

pytest test_blinds.py -v