Content
# 💡 IntelliGlow - AI-Powered Smart Lighting
**"Smart lighting, brilliantly simple"**
IntelliGlow is a Model Context Protocol (MCP) server that allows AI assistants like Claude to control **real smart bulbs** via UDP network communication. This Python implementation features voice commands, AI reasoning, and direct hardware control.
## 🏗️ **Architecture**
```
Voice/AI ──> IntelliGlow MCP ──> UDP Network ──> Smart Bulb (192.168.1.45:4000)
```
**The smart bulb system that actually thinks!**
## 🌟 **Features**
### **🔴 Real Hardware Support**
- **UDP Network Communication**: Direct communication with real smart bulbs
- **Default Bulb Configuration**: Connects to `192.168.1.45:4000` by default
- **Network Discovery**: Automatically find smart bulbs on your network
- **Connection Management**: Persistent connections with auto-reconnect
### **🎤 Voice Intelligence**
- **Natural Voice Commands**: "Turn on lights", "Set brightness to 75", "Make it blue"
- **AI-Powered Parsing**: Understands context and natural language
- **Text-to-Speech Feedback**: Speaks responses back to you
- **Smart Color Recognition**: Recognizes color names and descriptive terms
### **🧠 AI Integration**
- **MCP Protocol**: Works with Claude, GPT, and other AI models
- **Context Understanding**: AI can reason about lighting needs
- **Workflow Integration**: Bulbs become part of larger AI workflows
- **Learning Capability**: Can adapt to user patterns and preferences
### **🔧 Smart Bulb Control**
- **Power Control**: Turn bulbs on/off via UDP commands
- **Brightness Control**: Adjust brightness levels (0-100%)
- **Color Control**: Full RGB control with hex color codes (#FF0000)
- **Status Monitoring**: Get real-time bulb status
- **Ping/Connectivity**: Test network connectivity to bulbs
### **🌐 Network Features**
- **Multi-bulb Support**: Connect to multiple bulbs simultaneously
- **Discovery**: Scan network for available smart bulbs
- **Environment Configuration**: Set bulb IP/port via environment variables
## 🚀 **Quick Start**
### **Installation**
1. **Install IntelliGlow**:
```bash
# Core system
pip install -e .
# With voice capabilities
pip install -e .[voice]
```
2. **Configure your bulb** (optional):
```bash
export BULB_IP=192.168.1.45 # Your bulb's IP
export BULB_PORT=4000 # Your bulb's port
```
### **Running IntelliGlow**
```bash
# 1. MCP server only (for AI integration)
mcp-server-smartbulb
# 2. Voice interface only
mcp-server-smartbulb-voice
# 3. Complete IntelliGlow system (voice + AI + MCP)
python voice_enabled_server.py
```
### **Testing Network Connectivity**
```bash
# Test UDP communication with your real bulb
python test_network_bulbs.py
```
## 🔧 **AI Integration (Claude Desktop)**
Add this to your Claude Desktop `claude_desktop_config.json`:
```json
{
"mcpServers": {
"intelliglow": {
"command": "python",
"args": ["-m", "mcp_server_smartbulb.network_server"],
"cwd": "/path/to/your/IntelliGlow",
"env": {
"BULB_IP": "192.168.1.45",
"BULB_PORT": "4000"
}
}
}
}
```
## 🛠️ **Available Commands**
### **🎤 Voice Commands**
- *"Turn on the lights"* - Power control
- *"Set brightness to 75 percent"* - Brightness with smart parsing
- *"Make it blue"* - Color recognition
- *"How are the lights?"* - Status inquiry
- *"Find smart bulbs"* - Network discovery
### **🤖 MCP Tools (for AI)**
- `discover_bulbs()` - Find smart bulbs on the network
- `connect_to_bulb(ip, port)` - Connect to a specific bulb
- `turn_on_bulb(ip, port)` - Turn on a bulb via UDP
- `turn_off_bulb(ip, port)` - Turn off a bulb via UDP
- `set_bulb_brightness(brightness, ip, port)` - Set brightness (0-100)
- `set_bulb_color(color, ip, port)` - Set color using hex codes
- `get_bulb_status(ip, port)` - Get current bulb status
- `ping_bulb(ip, port)` - Test connectivity to a bulb
## 📡 **Network Configuration**
### **Default Bulb Setup**
IntelliGlow connects to `192.168.1.45:4000` by default. You can override this:
```bash
export BULB_IP=192.168.1.100
export BULB_PORT=4001
```
### **Bulb Configuration File**
Create `bulb_config.json`:
```json
{
"default_bulb": {
"ip": "192.168.1.45",
"port": 4000,
"timeout": 5.0
},
"discovery": {
"enabled": true,
"timeout": 10.0,
"port_range": {
"start": 4000,
"end": 4010
}
}
}
```
## 🔍 **IntelliGlow vs Traditional Solutions**
| Feature | **Alexa/Google** | **IntelliGlow** |
|---------|------------------|-----------------|
| **Voice Control** | ✅ Basic commands | ✅ Natural language + AI reasoning |
| **AI Integration** | ❌ Limited ecosystem | ✅ Works with any AI model (Claude, GPT, etc.) |
| **Hardware Control** | ❌ Cloud-dependent | ✅ Direct UDP networking |
| **Customization** | ❌ Vendor limitations | ✅ Full control over protocol |
| **Context Understanding** | ❌ Simple keywords | ✅ AI understands context and workflows |
| **Privacy** | ❌ Cloud processing | ✅ Local processing |
| **Developer Freedom** | ❌ Closed ecosystem | ✅ Open protocol, extensible |
**Result**: IntelliGlow = Convenience of Alexa + Intelligence of AI + Freedom of Open Source! 🎉
## 🧪 **Testing**
```bash
# Test real UDP communication with your bulb
python test_network_bulbs.py
```
This will:
1. 🔌 Test direct connection to 192.168.1.45:4000
2. 🔍 Scan network for other bulbs
3. 🤖 Simulate AI/MCP commands
4. 🎤 Test voice command processing
## 🐛 **Troubleshooting**
### **No Bulb Found**
- Ensure your smart bulb is on the same network
- Check that the bulb is listening on port 4000
- Try network discovery: `python -c "import asyncio; from mcp_server_smartbulb.bulb_discovery import BulbDiscovery; asyncio.run(BulbDiscovery().discover_bulbs())"`
### **Voice Not Working**
- Install voice dependencies: `pip install -e .[voice]`
- Check microphone permissions
- Test with: `python -m mcp_server_smartbulb.voice_interface`
### **Connection Timeout**
- Check firewall settings
- Verify bulb IP address
- Increase timeout in `bulb_config.json`
## 📁 **Project Structure**
```
IntelliGlow/
├── mcp_server_smartbulb/
│ ├── __init__.py # Package initialization
│ ├── network_server.py # Main UDP-enabled MCP server
│ ├── udp_client.py # UDP networking client
│ ├── bulb_discovery.py # Network discovery
│ └── voice_interface.py # Voice command processing
├── bulb_config.json # Network configuration
├── test_network_bulbs.py # UDP testing script
├── voice_enabled_server.py # Complete IntelliGlow system
├── README.md # This file
└── pyproject.toml # Project configuration
```
**Clean, focused, and intelligent! 🧠💡**
## 🎯 **What Makes IntelliGlow Special**
**IntelliGlow isn't just another smart bulb controller - it's the bridge between AI intelligence and physical hardware.**
### **🔥 Key Innovations:**
- **AI-Native Design**: Built for AI reasoning, not just voice commands
- **Open Protocol**: Works with any AI model, not locked to one vendor
- **Local Processing**: Privacy-focused, no cloud dependency required
- **Hybrid Interface**: Voice + AI chat + MCP protocol
- **Developer Freedom**: Full customization and extensibility
### **🌟 Real-World Magic:**
```
User: "I'm working late and need focus lighting"
IntelliGlow:
→ AI understands context
→ Sets cool white light (5000K)
→ Optimal brightness (85%)
→ Direct UDP communication
→ Responds with confirmation
```
**This is the future of smart homes - lighting that truly understands and adapts to your needs!** 🚀
---
**Made with ❤️ for the next generation of intelligent home automation**
