IoEHub MQTT MCP 서버

What is IoEHub MQTT MCP 서버?

IoEHub MQTT MCP 서버 is a Model Context Protocol (MCP) server that reads temperature sensor data and controls an LED via MQTT. It uses the FastMCP framework, communicates with an MQTT broker, and interacts with IoT devices through JSON-RPC over stdio.

How to use IoEHub MQTT MCP 서버?

Run the server with python mcp_server.py. From an MCP client, invoke ioehub_mqtt_get_temperature() to read temperature or ioehub_mqtt_set_led(pin, state) to control an LED. Configuration for Claude Desktop is provided in the README.

Key features of IoEHub MQTT MCP 서버

• Reads temperature from a sensor on pin 13.
• Controls LED state on a specified pin.
• Uses MQTT for device communication.
• Implements JSON‑RPC 2.0 for client‑server interaction.
• Provides a 5‑second response timeout.
• Outputs debug messages to stderr.

Use cases of IoEHub MQTT MCP 서버

• Monitor ambient temperature via an MQTT‑connected sensor.
• Remotely turn an LED on or off through an MQTT broker.
• Integrate temperature readings and LED control into an AI assistant (e.g., Claude).

FAQ from IoEHub MQTT MCP 서버

What MQTT broker address does the server use?

The server connects to broker at 172.30.1.100 on port 1883, with username ioehub and password password.

What protocols are used?

The server uses JSON‑RPC 2.0 over stdio between client and server, and MQTT (JSON payloads) between server and IoT devices.

What happens if the MQTT broker is not running?

The server requires the MQTT broker to be running. If connection fails, an error message is printed.

What is the response timeout?

The server waits up to 5 seconds for a response from the device. If none arrives, it returns a default value.

What are the dependencies to run the server?

Python packages mcp and paho-mqtt are required. A Python environment can be set up using uv venv .venv and then uv pip install mcp paho-mqtt.