返回 MCP 目录
public公开dns本地运行

EMQX

EMQX MCP Server是一个实现Model Context Protocol (MCP)的服务器,提供与EMQX MQTT代理的交互功能。

article

README

🚀 EMQX MCP 服务器

EMQX 是一款功能强大的 MQTT 代理,能支撑大规模的物联网应用。而 MCP(Management Control Plane)作为 EMQX 的管理控制平面,提供了丰富的 API 接口,可用于管理和监控 EMQX 集群。

🚀 快速开始

EMQX MCP 服务器为用户提供了便捷的方式来管理和监控 EMQX 集群。通过其丰富的 API 接口,用户可以轻松地执行各种操作,如列举客户端、获取客户端详细信息、发布消息以及断开客户端连接等。

✨ 主要特性

  • 列举客户端:能够列出当前连接到 MQTT 代理的所有客户端。
  • 获取客户端详细信息:可获取特定客户端的详细信息,涵盖连接状态、协议版本等内容。
  • 发布消息:支持向指定主题发布消息,且支持不同的 QoS 级别(0, 1, 2)。
  • 断开客户端连接:可强制断开指定客户端的连接。

💻 使用示例

基础用法

以下是通过与 LLM 对话来操作 MQTT 代理的示例:

### 用户:
请列出 MQTT 代理上连接的所有客户端。

### LLM 回应:
以下是当前连接到您的 MQTT 代理的客户端列表:

```text
ClientId: mqttx_2232bdb1
Username: test
Protocol: MQTT v5

目前有 1 个客户端连接到您的 MQTT 代理。您是否需要更多关于此客户端的详细信息,或者对 MQTT 代理执行其他操作?


### 高级用法
```text
### 用户:
请编写一首诗并将其发送到主题 `/poem`,使用 QoS 1。

### LLM 回应:
我将为您创作一首诗并将其发布到主题 `/poem`,使用 QoS 1。让我为您完成此事。

...
我已经成功地将这首诗发布到了主题 `/poem`,使用 QoS 1。消息已送达,ID 为:00062F55A1EFB1156ABC481240B30000。

我发布的诗歌如下:

- 电波在空中流转,
- 纤细的线将世界相连,
- 设备轻声细语,
- 跨越数字的鸿溝。
- 消息如葉落般飄散,
- 往 clouds 的彼端守侯,
- 連接卻不羈絆,
- 沉默之中無聲鳴。
- 現代的-age 星辰,
- 每一顆星光都有其価値,
- 械的语言,
- 改寫我們的地球。

您是否希望对 MQTT 代理执行其他操作?

📄 许可证

该项目采用 Apache License Version 2.0 协议授权,具体内容请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端