MQTTX SSE Server

What is MQTTX SSE Server?

MQTTX SSE Server is an implementation of the Model-Context Protocol (MCP) that enables MQTT operations over Server-Sent Events (SSE) transport. It allows AI assistants to interact with MQTT brokers through standardized MCP tools, providing real‑time message delivery and session management for multiple clients.

How to use MQTTX SSE Server?

Install Node.js (v14 or later) and npm, clone the repository, run npm install, then start the server with npm start (default port 4000). In MQTTX settings, add an MCP server entry with the URL http://localhost:4000/mqttx/sse under mcpServers.

Key features of MQTTX SSE Server

• Implements MCP protocol version 2024‑11‑05
• Uses SSE (Server‑Sent Events) as the transport layer
• Provides MQTT Connect, Subscribe, and Publish tools
• Real‑time message delivery from subscribed topics
• Session management for multiple clients
• JSON‑RPC API for tool calls and responses

Use cases of MQTTX SSE Server

• AI assistant subscribing to IoT sensor data via an MQTT broker
• Publishing commands to actuators from an AI chat interface
• Connecting to multiple MQTT brokers in a single session
• Real‑time monitoring dashboards powered by AI conversations

FAQ from MQTTX SSE Server

What MCP protocol version does the server implement?

It implements MCP protocol version 2024‑11‑05.

What transport protocol is used?

The server uses Server‑Sent Events (SSE) as the transport layer.

What MQTT operations are available through the tools?

The server provides three tools: mqttConnect to connect to an MQTT broker, mqttSubscribe to subscribe to a topic, and mqttPublish to publish messages to a topic.

What are the prerequisites and default port?

Prerequisites are Node.js v14 or later and npm. The server starts on port 4000 by default.

How do I configure this server in MQTTX?

Add the following configuration to your MQTTX settings: { "mcpServers": { "mqttx-server": { "url": "http://localhost:4000/mqttx/sse" } } }.