MQTTX：MQTT 5.0 客户端工具箱

项目简介

MQTTX 是 EMQ 开源的跨平台 MQTT 5.0 客户端工具箱，用于开发、测试和排查 IoT 应用。它提供桌面端、命令行工具和 Web 客户端：桌面端运行在 macOS、Windows、Linux，采用聊天式界面管理多个连接与订阅，并内置 MQTTX Agent 可用自然语言建立连接、收发消息和排查问题；CLI 面向终端与自动化，支持消息收发、基准测试和数据模拟；Web 客户端可在浏览器中通过 WebSocket 调试 MQTT，无需安装。

主要功能

• 桌面端与 CLI 支持 MQTT 3.1、3.1.1、5.0，可通过 TCP、TLS 和 WebSocket 连接。
• 桌面端支持连接分组、消息搜索、连接配置导入导出，以及 JSON、Base64、Hex、Protobuf/Avro 等载荷编解码和 GZIP 解压。
• 桌面端提供脚本测试、定时消息、Topic Tree、Dashboard、Payload Inspector 等分析工具。
• 内置 MQTTX Agent，可通过工具创建连接、订阅发布、读取消息、构建 Topic Tree 和仪表盘，并调用 MCP 服务器。
• CLI 提供 mqttx conn、mqttx pub、mqttx sub、mqttx bench、mqttx simulate 等命令，支持 stdin、管道、JSON/YAML 配置和多种载荷编解码。
• Web 客户端支持 MQTT 3.1.1 和 5.0 over WebSocket，可管理多个连接与订阅，也可用 Docker 自托管。

安装与使用

桌面端可从 GitHub Releases 或 EMQ 下载站获取安装包；macOS 也可用 Homebrew：

brew install --cask mqttx

CLI 安装脚本：

macOS / Linux：

curl -fsSL https://emqx.sh/mqttx | sh

Windows PowerShell：

irm https://emqx.sh/mqttx.ps1 | iex

安装后可在两个终端分别订阅和发布：

mqttx sub -h broker.emqx.io -t 'mqttx/quickstart'
mqttx pub -h broker.emqx.io -t 'mqttx/quickstart' -m '{"temperature":23.5}'

Web 客户端可打开 在线客户端，或使用 Docker 自托管：

docker run -d --name mqttx-web -p 80:80 emqx/mqttx-web:latest

注意事项

• Web 客户端使用 ws:// 或 wss://；HTTPS 页面需要 wss://。
• MQTTX Agent 的对话和工具结果会发送到你配置的模型服务商，请避免在聊天中输入密钥。
• 升级到 v1.13.3 后，请检查使用 %c 的订阅主题。
• 项目采用 Apache-2.0 许可证。

---

本作品整理自 GitHub 开源项目 emqx/MQTTX，原作者 @emqx，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。