mqttx

基于SSE和MCP协议,连接并操作MQTT代理的服务端工具。

安装使用

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

帮我安装这个 AI Skill:mqttx。
它的用途是:基于SSE和MCP协议,连接并操作MQTT代理的服务端工具。
完整的 Skill 内容见:https://321skill.com/skills/mqttx/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“请连接到我的MQTT测试服务器 mqtt://test.com,并订阅‘sensor/temperature’主题,告诉我最新的温度数据。”,它会通过配置好的mcp-sse-server建立连接,订阅指定主题,并将接收到的实时温度消息反馈给你。或者你可以说:“向‘device/light’主题发布一条消息,内容为‘ON’。”,AI会帮你完成消息的发布操作。

介绍

该Skill解决了在AI Agent开发中,需要与MQTT消息代理进行安全、便捷连接和操作的问题。传统方式需要编写复杂的网络通信代码,而此工具通过MCP(Model Context Protocol)协议和SSE(Server-Sent Events)传输,将MQTT的连接、订阅、发布等操作标准化为AI可调用的接口。

使用时,你需要部署此服务端,并将其作为MCP服务器配置到你的AI开发工具(如Claude Desktop)中。之后,你就可以通过自然语言或结构化指令,让AI Agent帮你连接MQTT服务器、订阅主题接收消息,或向指定主题发布消息,无需关心底层的网络细节。

它非常适合智能体开发者和物联网应用开发者。对于正在开发需要与硬件设备、传感器或其他MQTT客户端进行通信的AI Agent的开发者来说,这个Skill能极大简化集成流程。

建议在需要AI处理实时数据流或控制物联网设备的场景中使用。请注意,你需要自行准备并配置好目标MQTT代理服务器(如EMQX、Mosquitto)的地址和认证信息。该服务本身不提供MQTT代理功能,仅作为连接桥梁。

核心特点

核心区别在于,它并非直接实现MQTT客户端,而是通过MCP协议将MQTT能力“暴露”给AI Agent,使得AI可以直接理解和操作MQTT,实现了AI与物联网协议间的无缝桥接。同时,采用SSE作为传输层,更适合需要服务器向客户端主动推送消息的实时场景。

注意事项

不适合需要直接处理底层MQTT协议包或进行高性能、低延迟大规模消息转发的场景。

常见问题

这个Skill需要我自己有MQTT服务器吗?

是的,你需要一个可访问的MQTT代理服务器(如EMQX、Mosquitto),本工具是连接它的客户端服务。

它支持哪些MQTT特性?

支持基础的连接、订阅、发布和消息接收,具体支持的MQTT版本和高级特性(如遗嘱消息、保留消息)需参考项目文档。

给 AI 助手的安装指引

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

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