Intelliglow AI Voice MCP IoT Platform

🚀 IntelliGlow - 由人工智能驅動的智能照明系統

“智能照明，極致簡約”

IntelliGlow 是一個模型上下文協議（MCP）服務器，它允許像 Claude 和 ChatGPT 這樣的人工智能助手通過 UDP 網絡通信來控制真正的智能燈泡。這個基於 Python 的實現具備語音命令、人工智能推理和直接硬件控制等功能。

🚀 快速開始

安裝

1. 安裝 IntelliGlow：

   # 核心系統
   pip install -e .
   
   # 具備語音功能
   pip install -e .[voice]
   

2. 配置你的燈泡（可選）：

   export BULB_IP=192.168.1.45    # 你的燈泡 IP 地址
   export BULB_PORT=4000          # 你的燈泡端口號
   

運行 IntelliGlow

# 1. 僅運行 MCP 服務器（用於人工智能集成）
mcp-server-smartbulb

# 2. 僅運行語音接口
mcp-server-smartbulb-voice

# 3. 運行完整的 IntelliGlow 系統（語音 + 人工智能 + MCP）
python voice_enabled_server.py

測試網絡連接

# 測試與你真實燈泡的 UDP 通信
python test_network_bulbs.py

✨ 主要特性

🔴 支持真實硬件

• UDP 網絡通信：與真實的智能燈泡直接通信
• 默認燈泡配置：默認連接到 192.168.1.45:4000
• 網絡發現：自動在你的網絡中查找智能燈泡
• 連接管理：持久連接並具備自動重連功能

🎤 語音智能

• 自然語音命令：如“打開燈”、“將亮度設置為 75”、“把燈調成藍色”
• 人工智能解析：理解上下文和自然語言
• 文本轉語音反饋：將響應語音反饋給你
• 智能顏色識別：識別顏色名稱和描述性術語

🧠 人工智能集成

• MCP 協議：可與 Claude、GPT 等人工智能模型配合使用
• 上下文理解：人工智能可以推理照明需求
• 工作流集成：燈泡成為更大人工智能工作流的一部分
• 學習能力：可以適應用戶的使用模式和偏好

🔧 智能燈泡控制

• 電源控制：通過 UDP 命令打開/關閉燈泡
• 亮度控制：調節亮度級別（0 - 100%）
• 顏色控制：使用十六進制顏色代碼（#FF0000）進行全 RGB 控制
• 狀態監控：獲取燈泡的實時狀態
• Ping/連接性：測試與燈泡的網絡連接

🌐 網絡特性

• 多燈泡支持：同時連接多個燈泡
• 發現功能：掃描網絡以查找可用的智能燈泡
• 環境配置：通過環境變量設置燈泡的 IP 地址和端口號

📦 安裝指南

安裝

1. 安裝 IntelliGlow：

   # 核心系統
   pip install -e .
   
   # 具備語音功能
   pip install -e .[voice]
   

2. 配置你的燈泡（可選）：

   export BULB_IP=192.168.1.45    # 你的燈泡 IP 地址
   export BULB_PORT=4000          # 你的燈泡端口號
   

💻 使用示例

基礎用法

# 安裝 IntelliGlow
pip install -e .

# 運行 MCP 服務器
mcp-server-smartbulb

高級用法

# 運行具備語音功能的完整 IntelliGlow 系統
python voice_enabled_server.py

📚 詳細文檔

🔧 人工智能集成（Claude 桌面版）

將以下內容添加到你的 Claude 桌面版 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"
      }
    }
  }
}

🛠️ 可用命令

🎤 語音命令

• “打開燈” - 電源控制
• “將亮度設置為 75%” - 智能解析亮度控制
• “把燈調成藍色” - 顏色識別
• “燈的狀態如何？” - 狀態查詢
• “查找智能燈泡” - 網絡發現

🤖 MCP 工具（用於人工智能）

• discover_bulbs() - 在網絡中查找智能燈泡
• connect_to_bulb(ip, port) - 連接到特定的燈泡
• turn_on_bulb(ip, port) - 通過 UDP 命令打開燈泡
• turn_off_bulb(ip, port) - 通過 UDP 命令關閉燈泡
• set_bulb_brightness(brightness, ip, port) - 設置亮度（0 - 100）
• set_bulb_color(color, ip, port) - 使用十六進制代碼設置顏色
• get_bulb_status(ip, port) - 獲取當前燈泡的狀態
• ping_bulb(ip, port) - 測試與燈泡的連接性

📡 網絡配置

默認燈泡設置

IntelliGlow 默認連接到 192.168.1.45:4000。你可以通過以下方式覆蓋此設置：

export BULB_IP=192.168.1.100
export BULB_PORT=4001

燈泡配置文件

創建 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 與傳統解決方案對比

結論：IntelliGlow = Alexa 的便利性 + 人工智能的智能性 + 開源的自由度！🎉

🧪 測試

# 測試與你的燈泡的真實 UDP 通信
python test_network_bulbs.py

此測試將：

1. 🔌 測試與 192.168.1.45:4000 的直接連接
2. 🔍 掃描網絡以查找其他燈泡
3. 🤖 模擬人工智能/MCP 命令
4. 🎤 測試語音命令處理

🐛 故障排除

未找到燈泡

• 確保你的智能燈泡與設備在同一網絡中
• 檢查燈泡是否在端口 4000 上監聽
• 嘗試進行網絡發現：python -c "import asyncio; from mcp_server_smartbulb.bulb_discovery import BulbDiscovery; asyncio.run(BulbDiscovery().discover_bulbs())"

語音功能無法使用

• 安裝語音依賴項：pip install -e .[voice]
• 檢查麥克風權限
• 使用以下命令進行測試：python -m mcp_server_smartbulb.voice_interface

連接超時

• 檢查防火牆設置
• 驗證燈泡的 IP 地址
• 在 bulb_config.json 文件中增加超時時間

📁 項目結構

IntelliGlow/
├── mcp_server_smartbulb/
│   ├── __init__.py              # 包初始化 
│   ├── network_server.py        # 主要的支持 UDP 的 MCP 服務器
│   ├── udp_client.py           # UDP 網絡客戶端
│   ├── bulb_discovery.py       # 網絡發現
│   └── voice_interface.py      # 語音命令處理
├── bulb_config.json            # 網絡配置
├── test_network_bulbs.py       # UDP 測試腳本
├── voice_enabled_server.py     # 完整的 IntelliGlow 系統
├── README.md                   # 本文件
└── pyproject.toml              # 項目配置

🎯 IntelliGlow 的獨特之處

IntelliGlow 不僅僅是另一個智能燈泡控制器，它是人工智能智能與物理硬件之間的橋樑。

🔥 關鍵創新點

• 原生人工智能設計：專為人工智能推理而構建，不僅僅支持語音命令
• 開放協議：可與任何人工智能模型配合使用，不侷限於單一供應商
• 本地處理：注重隱私，無需依賴雲服務
• 混合接口：語音 + 人工智能聊天 + MCP 協議
• 開發者自由度高：可完全定製和擴展

🌟 現實應用場景

用戶：“我要工作到很晚，需要專注照明”
IntelliGlow： 
→ 人工智能理解上下文
→ 設置為冷白光（5000K）
→ 調整到最佳亮度（85%）
→ 通過直接 UDP 通信控制
→ 回覆確認信息

這就是智能家居的未來——照明真正理解並適應你的需求！🚀

懷著對下一代智能家庭自動化的熱愛而打造 ❤️