Mqtt Mcp
About
A Model Context Protocol (MCP) server for MQTT.
Details
- License
- MIT license
Explore
- Maps MQTT topics to MCP resources and tools
- Supports receiving and publishing MQTT messages
- Bearer token authentication via RSA public key
- Interactive prompts for guiding LLM interactions
- Docker deployment support
- Example integrations with OpenAI Agents SDK and OpenAI Python library
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mqtt McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The server is built with FastMCP 2.0 and uses uv for project and dependency management. Simply run the following command to install uv or check out the installation guide for more details and alternative installation methods.
curl -LsSf https://astral.sh/uv/install.sh | sh
Clone the repository, then use uv to install project dependencies and create a virtual environment.
git clone https://github.com/ezhuk/mqtt-mcp.git
cd mqtt-mcp
uv sync
Start the MQTT MCP server by running the following command in your terminal. It defaults to using the Streamable HTTP transport on port 8000.
uv run mqtt-mcp
To confirm the server is up and running and explore available resources and tools, run the MCP Inspector and connect it to the MQTT MCP server at http://127.0.0.1:8000/mcp/. Make sure to set the transport to Streamable HTTP.
npx @modelcontextprotocol/inspector
To enable Bearer Token authentication for the Streamable HTTP transport, provide the RSA public key in PEM format in the .env file. Check out the Bearer Token Authentication section for more details.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mqtt mcp": {
"mqtt-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"mqtt-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}A lightweight Model Context Protocol (MCP) server that connects LLM agents to MQTT devices in a secure, standardized way, enabling seamless integration of AI-driven workflows with Building Automation (BAS), Industrial Control (ICS) and Smart Home systems, allowing agents to monitor real-time sensor data, actuate devices, and orchestrate complex automation tasks.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
