EMQX MCP Server

Features

MQTT Client Management

• Client Listing: View all connected MQTT clients with flexible filtering options

• Client Information: Retrieve detailed information about specific clients

• Connection Control: Disconnect problematic or stale clients from the broker

• Flexible Filtering: Filter clients by node, username, client ID, connection state, and more

MQTT Message Publishing

• Topic-based Publishing: Send messages to any MQTT topics

• QoS Control: Select Quality of Service level (0, 1, or 2) for reliable delivery

• Message Retention: Option to persist messages for new subscribers

• Custom Payloads: Support for any message content format

Tools

list_mqtt_clients

• List MQTT clients connected to your EMQX Cluster

• Inputs:

get_mqtt_client

• Get detailed information about a specific MQTT client by client ID

• Inputs:

kick_mqtt_client

• Disconnect a client from the MQTT broker by client ID

• Inputs:

publish_mqtt_message

• Publish an MQTT Message to Your EMQX Cluster on EMQX Cloud or Self-Managed Deployment

• Inputs:

Setup EMQX Cluster

1. EMQX Cloud Serverless Deployment:

• The easiest way to get started with.

• Obtain a free serverless deployment from EMQX Cloud

• Sign up at EMQX Cloud Serverless

1. EMQX Cloud Dedicated Deployment:

• Provides dedicated resources for production workloads

• Offers enhanced performance, reliability, and customization options

• Supports various cloud providers (AWS, GCP, Azure)

• Includes professional SLA and support

• Create a deployment at EMQX Cloud Dedicated

1. Self-hosted EMQX Platform:

• Download and deploy EMQX Platform locally

• Follow installation instructions at EMQX Platform

Running locally with the Claude Desktop App

Option 1: Installing via Smithery

Option 2: Docker

1. Install Claude Desktop App if you haven't done so yet.

2. Pull the image:

3. Add the following to your claude_desktop_config.json file: Note: Update the env variables:EMQX_API_URL, EMQX_API_KEY, EMQX_API_SECRET

4. Open or Restart Claude Desktop App

5. Try asking Claude to do something with the MQTT broker (e.g. ask it to publish an MQTT message to a topic).

Option 3: Manual Installation

1. Install Claude Desktop App if you haven't done so yet.

2. Clone this repository.

3. Add the following to your claude_desktop_config.json file: Note: Make sure to update path/to/repo/src/emqx_mcp_server to the actual path and modify the environment variables EMQX_API_URL, EMQX_API_KEY, and EMQX_API_SECRET to match your EMQX instance.

4. Open or Restart Claude Desktop App

5. Try asking Claude to do something with the MQTT broker (e.g. ask it to publish an MQTT message to a topic).

Example Prompts

License

EMQX MCP Server

Features

MQTT Client Management

• Client Listing: View all connected MQTT clients with flexible filtering options

• Client Information: Retrieve detailed information about specific clients

• Connection Control: Disconnect problematic or stale clients from the broker

• Flexible Filtering: Filter clients by node, username, client ID, connection state, and more

MQTT Message Publishing

• Topic-based Publishing: Send messages to any MQTT topics

• QoS Control: Select Quality of Service level (0, 1, or 2) for reliable delivery

• Message Retention: Option to persist messages for new subscribers

• Custom Payloads: Support for any message content format

Tools

list_mqtt_clients

• List MQTT clients connected to your EMQX Cluster

• Inputs:

get_mqtt_client

• Get detailed information about a specific MQTT client by client ID

• Inputs:

kick_mqtt_client

• Disconnect a client from the MQTT broker by client ID

• Inputs:

publish_mqtt_message

• Publish an MQTT Message to Your EMQX Cluster on EMQX Cloud or Self-Managed Deployment

• Inputs:

Setup EMQX Cluster

1. EMQX Cloud Serverless Deployment:

• The easiest way to get started with.

• Obtain a free serverless deployment from EMQX Cloud

• Sign up at EMQX Cloud Serverless

1. EMQX Cloud Dedicated Deployment:

• Provides dedicated resources for production workloads

• Offers enhanced performance, reliability, and customization options

• Supports various cloud providers (AWS, GCP, Azure)

• Includes professional SLA and support

• Create a deployment at EMQX Cloud Dedicated

1. Self-hosted EMQX Platform:

• Download and deploy EMQX Platform locally

• Follow installation instructions at EMQX Platform

Running locally with the Claude Desktop App

Option 1: Installing via Smithery

Option 2: Docker

1. Install Claude Desktop App if you haven't done so yet.

2. Pull the image:

3. Add the following to your claude_desktop_config.json file: Note: Update the env variables:EMQX_API_URL, EMQX_API_KEY, EMQX_API_SECRET

4. Open or Restart Claude Desktop App

5. Try asking Claude to do something with the MQTT broker (e.g. ask it to publish an MQTT message to a topic).

Option 3: Manual Installation

1. Install Claude Desktop App if you haven't done so yet.

2. Clone this repository.

3. Add the following to your claude_desktop_config.json file: Note: Make sure to update path/to/repo/src/emqx_mcp_server to the actual path and modify the environment variables EMQX_API_URL, EMQX_API_KEY, and EMQX_API_SECRET to match your EMQX instance.

4. Open or Restart Claude Desktop App

5. Try asking Claude to do something with the MQTT broker (e.g. ask it to publish an MQTT message to a topic).

Example Prompts

License