💡 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
- Install IntelliGlow:
# Core system
pip install -e .
# With voice capabilities
pip install -e .[voice]
- Configure your bulb (optional):
export BULB_IP=192.168.1.45 # Your bulb's IP
export BULB_PORT=4000 # Your bulb's port
Running IntelliGlow
# 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
# 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:
{
"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
discover_bulbs() - Find smart bulbs on the networkconnect_to_bulb(ip, port) - Connect to a specific bulbturn_on_bulb(ip, port) - Turn on a bulb via UDPturn_off_bulb(ip, port) - Turn off a bulb via UDPset_bulb_brightness(brightness, ip, port) - Set brightness (0-100)set_bulb_color(color, ip, port) - Set color using hex codesget_bulb_status(ip, port) - Get current bulb statusping_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:
export BULB_IP=192.168.1.100
export BULB_PORT=4001
Bulb Configuration File
Create bulb_config.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
# Test real UDP communication with your bulb
python test_network_bulbs.py
This will:
- 🔌 Test direct connection to 192.168.1.45:4000
- 🔍 Scan network for other bulbs
- 🤖 Simulate AI/MCP commands
- 🎤 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