mcp2mqtt

通过MCP协议与MQTT桥接,实现用自然语言控制物联网硬件。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mcp2mqtt。
它的用途是:通过MCP协议与MQTT桥接,实现用自然语言控制物联网硬件。
完整的 Skill 内容见:https://321skill.com/skills/mcp2mqtt/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把书桌的台灯调暗到30%的亮度。”,它会通过mcp2mqtt向MQTT代理发布一条控制台灯亮度的指令,最终由连接到MQTT的硬件控制器执行。或者

对AI说:“现在室内温度是多少?”,它会通过MQTT订阅温度传感器的主题并获取最新数据,然后以自然语言回复给你。

介绍

mcp2mqtt 旨在解决AI大模型与物理世界硬件设备之间的交互鸿沟。传统上,用户需要通过复杂的代码或专用APP来控制智能家居、传感器等物联网设备。该Skill通过实现MCP(Model Context Protocol)服务器并桥接到MQTT协议,让AI助手能够理解用户的自然语言指令,并转化为具体的设备控制命令,从而实现对灯泡、开关、传感器等硬件的直接操控。

使用时,用户需要先部署并运行mcp2mqtt服务,配置好其与本地MQTT代理(如Mosquitto)的连接,并确保目标物联网设备已接入同一MQTT网络。之后,在支持MCP协议的AI助手(如Claude Desktop)中配置该MCP服务器地址。完成配置后,用户即可直接通过对话向AI助手发出如“打开客厅的灯”、“查询卧室温度”等指令。

该Skill非常适合智能体开发者、物联网应用开发者以及热衷于DIY智能家居的极客或高校学生。他们通常具备一定的技术背景,希望探索AI与物理设备结合的新玩法,或快速搭建智能家居的原型验证系统。

使用建议:请确保MQTT代理运行稳定且网络可达,并仔细配置设备主题(Topic)与指令的映射关系。由于涉及硬件控制,在正式投入使用前,建议在测试环境中充分验证指令的准确性和安全性,避免误操作。

核心特点

核心区别在于它并非直接控制硬件,而是作为MCP协议与MQTT协议之间的标准化桥梁,这使得任何支持MCP协议的AI助手(如Claude)都能通过它统一接入庞大的MQTT物联网生态,无需为每个AI助手或设备单独开发适配层。

注意事项

不适合对MQTT协议和网络配置不熟悉的纯终端用户直接使用,需要一定的技术部署和调试能力。

常见问题

mcp2mqtt支持哪些AI助手?

支持任何实现了MCP客户端协议的AI助手,例如Claude Desktop。理论上,未来支持MCP的Cursor、Windsurf等也可接入。

需要自己搭建MQTT服务器吗?

是的,你需要一个可访问的MQTT代理(如Mosquitto、EMQX),mcp2mqtt负责与之通信并转发AI指令。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mcp2mqtt/raw/index.md 读取 mcp2mqtt 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。