EMQX

🚀 EMQX MCP Server

EMQX is a powerful MQTT broker that supports large-scale IoT applications. MCP (Management Control Plane) is the management and control plane of EMQX, providing a rich set of API interfaces for managing and monitoring the EMQX cluster.

🚀 Quick Start

EMQX serves as a robust MQTT broker, well - suited for large - scale IoT applications. The MCP, as its management and control plane, offers a wide range of API interfaces to manage and monitor the EMQX cluster.

✨ Features

• List Clients: List all clients currently connected to the MQTT broker.
• Get Client Details: Retrieve detailed information about a specific client, including connection status, protocol version, etc.
• Publish Messages: Publish messages to a specified topic, supporting different QoS levels (0, 1, 2).
• Disconnect Clients: Forcefully disconnect a specified client.

💻 Usage Examples

Basic Usage

The following is an example of the interaction between the user and the system to manage the MQTT broker:

User:

Please list all clients connected to the MQTT broker.

LLM Response:

Here is a list of clients currently connected to your MQTT broker:

ClientId: mqttx_2232bdb1
Username: test
Protocol: MQTT v5

Currently, there is 1 client connected to your MQTT broker. Do you need more detailed information about this client or perform other operations on the MQTT broker?

User:

Please provide detailed information about this client.

LLM Response:

I will retrieve detailed information about this client for you.

Basic Information:

• Client ID: mqttx_2232bdb1
• Username: test

Connection Details:

• Is Connected: Yes
• Creation Time: 2025-03-02T05:29:51.103+00:00

Do you need to perform any operations on this client, such as publishing a message to a topic or disconnecting this client?

User:

Please write a poem and send it to the topic /poem with QoS 1.

LLM Response:

I will create a poem for you and publish it to the topic /poem with QoS 1. Let me handle this for you.

... I have successfully published the poem to the topic /poem with QoS 1. The message has been delivered, and the ID is: 00062F55A1EFB1156ABC481240B30000.

The poem I published is as follows:

• Radio waves flow in the air,
• Slender lines connect the world,
• Devices whisper softly,
• Crossing the digital divide.
• Messages drift like falling leaves,
• Waiting at the other end of the clouds,
• Connected but unshackled,
• Silent sounds in the quiet.
• Stars of the modern age,
• Each starlight has its value,
• The language of machines,
• Rewriting our Earth.

Do you want to perform other operations on the MQTT broker?

User:

Please kick out the client mqttx_2232bdb1.

LLM Response:

I will disconnect this client from the MQTT broker for you.

... The client mqttx_2232bdb1 has been successfully disconnected. The system returns:

The client mqttx_2232bdb1 has been disconnected

The MQTT client named "mqttx_2232bdb1" has been disconnected and is no longer connected to your broker. Do you want to perform other operations on the MQTT broker?

📄 License

This project is licensed under the Apache License Version 2.0. Please refer to the LICENSE file for specific details.