EMQX MCP Server

A Model Context Protocol (MCP) server implementation that provides EMQX MQTT broker interaction.

Catalog onlyCatalog onlySTDIO

Overview

EMQX MCP Server is a Model Context Protocol (MCP) server implementation that facilitates interaction between clients and the EMQX MQTT broker, enabling seamless communication within MQTT clusters.

To use the EMQX MCP Server, set up an EMQX cluster with the required API key and client authentication, then utilize the provided tools to manage MQTT clients and publish messages.

MQTT Client Management: View and manage connected MQTT clients with filtering options. - MQTT Message Publishing: Publish messages to MQTT topics with QoS control and message retention options. - Connection Control: Disconnect problematic clients from the broker.

Managing MQTT clients in a cloud-based or self-hosted environment.
Publishing messages to various topics for IoT applications.
Monitoring and controlling MQTT connections for better resource management.

Add to your AI client

Use these steps to connect EMQX MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "emqx-mcp-server-benniu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "emqx-mcp-server-benniu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "emqx-mcp-server-benniu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "emqx-mcp-server-benniu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emqx-mcp-server-benniu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "emqx-mcp-server-benniu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-emqx-mcp-server-benniu"
      ]
    }
  }
}

FAQ

What is the purpose of the EMQX MCP Server?

It allows clients to interact with EMQX MQTT clusters efficiently.

Is there a cloud deployment option?

Yes, EMQX offers a serverless cloud deployment for easy setup.

Can I run it locally?

Yes, you can self-host the EMQX MCP Server on your local machine.

Developer tools