EMQX MCP Server

Name: EMQX MCP Server
Author: Benniu

@Benniu

代码仓库

关于 EMQX MCP Server

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

基本信息

分类

其他

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

Benniu

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "emqx-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Benniu/emqx-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is EMQX MCP Server?

A Model Context Protocol (MCP) server that provides EMQX MQTT broker interaction, enabling MCP clients to manage MQTT clusters on EMQX Cloud or self-hosted deployments.

How to use EMQX MCP Server?

Install via Smithery, Docker, or manual clone with uv. Configure EMQX_API_URL, EMQX_API_KEY, and EMQX_API_SECRET environment variables pointing to your EMQX cluster, then add the server configuration to your Claude Desktop App claude_desktop_config.json.

Key features of EMQX MCP Server

List, inspect, and disconnect MQTT clients
Publish messages with QoS and retention control
Subscribe to topics via SSE with duration and message limits
Flexible client filtering by node, username, client ID
Support for EMQX Cloud and self-hosted clusters

Use cases of EMQX MCP Server

List all connected MQTT clients and inspect their details
Publish custom messages (e.g. poems, sensor data) to any topic
Subscribe to a topic for a set time and collect incoming messages
Disconnect problematic or stale clients from the broker
Manage MQTT infrastructure through natural language prompts in Claude

FAQ from EMQX MCP Server

How do I set up an EMQX cluster to use this server?

You can use EMQX Cloud Serverless (free), EMQX Cloud Dedicated, or a self-hosted EMQX Platform. All require a configured API Key and client authentication.

Does the `subscribe_mqtt_topic` tool work with self-hosted EMQX?

No, the subscribe tool uses an SSE endpoint that is only available on EMQX Cloud deployments. Self-hosted deployments may not support it.

What environment variables are needed?

EMQX_API_URL (your cluster’s API v5 endpoint), EMQX_API_KEY, and EMQX_API_SECRET must be set for the server to authenticate.

Can I filter clients by IP address or username?

Yes, the list_mqtt_clients tool supports filtering by node, client ID, username, IP address, connection state, and more, including fuzzy search patterns.

What is the maximum number of clients I can retrieve in one call?

The list_mqtt_clients tool accepts a limit parameter with a maximum of 10,000 results per page.

其他分类下的更多 MCP 服务器

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K