Smart Bulb Control via MCP Server With Claude

通过 MCP 服务与 Claude 控制智能灯泡

本项目演示如何使用 Node.js 和 TypeScript 构建 MCP（机器控制协议） 服务，通过 AI 驱动的命令自主控制智能灯泡。 它通过 UDP 通信和 ChatGPT 或 Claude 等 AI 接口，实现无缝、匿名且自动化的智能照明管理。

概述

本项目展示了：

• 通过 MCP 服务自主控制智能灯泡。
• 使用 Cursor ID 和 AI 客户端管理照明。
• 使用结构化 JSON 命令通过 UDP 与灯泡通信。
• 实时调整颜色和亮度。

工作原理

智能灯泡通信

• 智能灯泡（例如 Philips Hue）通过预定义端口上的 UDP 服务运行。
• 每个灯泡通过 Wi-Fi 网络中的专用 IP 地址连接。
• JSON 格式的命令（例如开灯／关灯、调整 RGB）会以 UDP 数据报的形式发送。

开发工具

• Node.js：用于编写 UDP 客户端。

• TypeScript：确保代码类型安全且易于扩展。

• NPM：用于安装依赖项的包管理器。

• MCP SDK：用于构建 MCP 服务的官方 SDK。

• dgram module：Node.js 内置的 UDP 套接字模块。

MCP 服务结构

工具创建 每个工具都对应一项灯泡控制操作（例如 turn_on、set_color），并通过架构定义预期输入。

灯泡功能

• turnOnBulb()：发送 UDP 命令以打开灯泡。

• turnOffBulb()：发送命令以关闭灯泡。

• setColor(r, g, b, dimming)：调整颜色和亮度。

错误处理 确保妥善处理连接并记录网络错误。

传输层 MCP 服务使用 stdio 传输与 Cursor 或其他 AI 平台交互，实现实时控制。

功能

• 通过 AI 或命令行输入打开／关闭灯泡。

• 动态设置 RGB 颜色。

• 使用调光百分比调整亮度。

• 将 AI 与 MCP 集成，实现自动化例程。

运行方法

• 安装依赖项

• pnpm install

• 构建 TypeScript 项目

• pnpm build

• 运行 MCP 服务

• npm start

确保你的智能灯泡：

• 已连接到同一网络。

• 已配置正确的 IP 和 UDP 端口。

未来构想

• 根据编码活动或天气调整照明。

• 添加色温支持。

• 与其他 IoT 设备集成（例如风扇、窗帘）。

• 构建 GUI，以直观展示实时控制状态。

贡献

• 欢迎提交拉取请求和反馈！让我们共同打造 AI 驱动的智能家居未来。

• 如果你希望在 README.md 中添加命令行示例、设置视频或 API 文档，请告诉我。

---