
benniu/emqx-mcp-server
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
EMQX MQTTブローカーの相互作用を提供するモデルコンテキストプロトコル(MCP)サーバーの実装.
概要
EMQX MQTTブローカーの相互作用を提供するモデルコンテキストプロトコル(MCP)サーバーの実装。 MCP クライアントを EMQX クラウド上の MQTT クラスター または セルフホストクラスター と やり取り - クライアントリスト: 柔軟なフィルタリングオプションで接続されているMQTTクライアントをすべて表示 - クライアント情報: 特定のクライアントに関する詳細な情報を取得する - 接続制御: ブローカーから問題のあるクライアントや屋台を切断する - 柔軟なフィルタリング: ノード、ユーザー名、クライアントID、接続状態などによるフィルタクライアント - トピックベースのパブリッシング:任意のMQTTトピックにメッセージを送信 - QoSコントロール:信頼できる配信のためのサービスレベル(0、1、または2)の品質を選択 - メッセージ保持:新しい加入者のための永続的なメッセージへのオプション - カスタムペイロード:任意のメッセージコンテンツフォーマットのサポート - リアルタイムサブスクリプション: Server-Sent Events(SSE) で MQTT トピックを購読します - 期間コントロール: メッセージ(1〜300秒)を聴く時間の設定 - メッセージ制限:メッセージの最大数を設定します...
概要(AI 翻訳)
EMQX MQTTブローカーの相互作用を提供するモデルコンテキストプロトコル(MCP)サーバーの実装。 MCP クライアントを EMQX クラウド上の MQTT クラスター または セルフホストクラスター と やり取り
##特徴
##MQTTクライアント管理
- クライアントリスト:柔軟なフィルタリングオプションで接続されているすべてのMQTTクライアントを見る
- クライアント情報:特定のクライアントに関する詳細情報を取得する
- 関係制御:ブローカーから問題のあるまたは屋台クライアントを切断
- 柔軟なフィルタリング:ノード、ユーザー名、クライアントID、接続状態などによるクライアントのフィルタリング
##MQTT メッセージ出版
- Topic-basedパブリッシング:あらゆるMQTTトピックにメッセージを送信する
- QoSの制御:信頼できる配達のためのサービス レベル(0、1、または2)の質を選んで下さい
- メッセージ保持:新しい加入者のための永続的なメッセージへのオプション
- カスタムペイロード:任意のメッセージコンテンツフォーマットのサポート
MQTT トピックサブスクリプション (SSE)
- リアルタイムサブスクリプション: Server-Sent Events(SSE) で MQTT トピックを購読
- 期間制御:メッセージ(1〜300秒)を聴く時間の設定
- メッセージ制限:サブスクリプションごとに収集するメッセージの最大数を設定します
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
EMQX MCP Server
A Model Context Protocol (MCP) server implementation that provides EMQX MQTT broker interaction. Enabling MCP clients to interact with the MQTT clusters on EMQX Cloud or self-hosted clusters
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
MQTT Topic Subscription (SSE)
- Real-time Subscription: Subscribe to MQTT topics via Server-Sent Events (SSE)
- Duration Control: Configure how long to listen for messages (1-300 seconds)
- Message Limiting: Set maximum number of messages to collect per subscription
- Automatic Parsing: Messages are automatically parsed from SSE event stream
Tools
list_mqtt_clients
- List MQTT clients connected to your EMQX Cluster
- Inputs:
- page (number, optional): Page number (default: 1)
- limit (number, optional): Results per page (default: 100, max 10000)
- node (string, optional): Filter by specific node name
- clientid (string, optional): Filter by specific client ID
- username (string, optional): Filter by specific username
- ip_address (string, optional): Filter by client IP address
- conn_state (string, optional): Filter by connection state
- clean_start (boolean, optional): Filter by clean start flag
- proto_ver (string, optional): Filter by protocol version
- like_clientid (string, optional): Fuzzy search by client ID pattern
- like_username (string, optional): Fuzzy search by username pattern
- like_ip_address (string, optional): Fuzzy search by IP address pattern
get_mqtt_client
- Get detailed information about a specific MQTT client by client ID
- Inputs:
- clientid (string, required): The unique identifier of the client to retrieve
kick_mqtt_client
- Disconnect a client from the MQTT broker by client ID
- Inputs:
- clientid (string, required): The unique identifier of the client to disconnect
publish_mqtt_message
- Publish an MQTT Message to Your EMQX Cluster on EMQX Cloud or Self-Managed Deployment
インストール
docker run -i --rm -e EMQX_API_URL=https://your-emqx-cloud-instance.com:8443/api/v5 -e EMQX_API_KEY=<YOUR-API-KEY> -e EMQX_API_SECRET=<YOUR-API-SECRET> benniuji/emqx-mcp-server