EMQX MCP Server logo

EMQX MCP Server

by Benniu

An implementation of a Model Context Protocol (MCP) server that enables interaction with EMQX MQTT brokers. It allows MCP clients to interact with MQTT clusters on EMQX Cloud or self-hosted clusters.

View on GitHub

Last updated: N/A

What is EMQX MCP Server?

The EMQX MCP Server is a Model Context Protocol server that facilitates communication between MCP clients and EMQX MQTT brokers. It provides tools for managing MQTT clients and publishing messages to EMQX clusters.

How to use EMQX MCP Server?

To use the EMQX MCP Server, you need to set up an EMQX cluster (either on EMQX Cloud or self-hosted) and configure the necessary API keys. Then, you can install the server using Smithery, Docker, or manual installation. Finally, configure the claude_desktop_config.json file with the appropriate command and environment variables.

Key features of EMQX MCP Server

  • MQTT Client Management (Listing, Information, Connection Control, Filtering)

  • MQTT Message Publishing (Topic-based, QoS Control, Message Retention, Custom Payloads)

  • Integration with EMQX Cloud and Self-hosted EMQX clusters

  • Tools for listing clients, getting client details, kicking clients, and publishing messages

Use cases of EMQX MCP Server

  • Managing and monitoring MQTT clients connected to an EMQX broker

  • Publishing messages to specific topics with different QoS levels

  • Disconnecting problematic or stale MQTT clients

  • Integrating MQTT functionality with Claude Desktop App

FAQ from EMQX MCP Server

How do I set up an EMQX cluster?

You can set up an EMQX cluster using EMQX Cloud Serverless Deployment, EMQX Cloud Dedicated Deployment, or a self-hosted EMQX Platform.

What is the Model Context Protocol (MCP)?

The Model Context Protocol (MCP) is a protocol that enables interaction with language models.

How do I install the EMQX MCP Server?

You can install the server using Smithery, Docker, or manual installation as described in the README.

What environment variables do I need to configure?

You need to configure EMQX_API_URL, EMQX_API_KEY, and EMQX_API_SECRET to connect to your EMQX instance.

How do I use the tools provided by the server?

The server provides tools to list, get, kick, and publish messages to the EMQX cluster. Refer to the README for the input parameters for each tool.