IoEHub MQTT MCP 서버

by ioehub

2 stars

3.5k downloads

Not rated

GitHub

Other

Description

# IoEHub MQTT MCP 서버 ## 1. 개요 이 문서는 MQTT를 통해 온도 센서 데이터를 읽고 LED를 제어하는 MCP(Model Context Protocol) 서버를 설명합니다. 이 서버는 FastMCP 프레임워크를 기반으로 하며, JSON-RPC 프로토콜을 사용하여 통신합니다. ### 1.1 구조도 <svg viewBox="0 0 800 600" xmlns="http://www.w3.org/2000/svg">  <rect x="50"…

About

Details

Author: ioehub
GitHub stars: 2
Downloads: 3,492
Categories: Other

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 IoEHub MQTT MCP 서버

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ioehub mqtt mcp \uc11c\ubc84": {
            "ioehub-mqtt-mcp-server": {
                "command": "python",
                "args": [
                    "mcp_server.py"
                ]
            }
        }
    }
}

McpServers

{
    "ioehub-mqtt-mcp-server": {
        "command": "python",
        "args": [
            "mcp_server.py"
        ]
    }
}

IoEHub MQTT MCP 서버

1. 개요

이 문서는 MQTT를 통해 온도 센서 데이터를 읽고 LED를 제어하는 MCP(Model Context Protocol) 서버를 설명합니다. 이 서버는 FastMCP 프레임워크를 기반으로 하며, JSON-RPC 프로토콜을 사용하여 통신합니다.

1.1 구조도

1.2 Key Components:

1. MCP Client (Claude AI) - Provides user interface - Sends JSON-RPC requests to MCP Server - Displays results to user 1. MCP Server (Python/FastMCP) - Processes client requests - Communicates with MQTT Broker - Translates between JSON-RPC and MQTT protocols 1. MQTT Broker (172.30.1.100) - Central hub for MQTT messages - Routes messages between server and devices - Handles publish/subscribe message pattern 1. IoT Device (Temperature Sensor/LED) - Physical hardware devices - Provides temperature data - Controls LED states based on commands

Data Flow:

1. Client → Server: Function call ioehub_mqtt_get_temperature() or ioehub_mqtt_set_led() 2. Server → Broker: Publishes MQTT message (topic: ioehub/mcp/command) 3. Broker → Device: Forwards command to appropriate device 4. Device → Broker: Publishes response with data (topic: ioehub/mcp/response) 5. Broker → Server: Delivers response to subscribed server 6. Server → Client: Returns function call result with processed data This vertical layout clearly shows the hierarchical flow of communication from client through server and broker to the IoT devices.

2. 시스템 구성

- 프레임워크: FastMCP - 통신 프로토콜: MQTT, JSON-RPC 2.0 - 구현 언어: Python - 지원 기능: 온도 측정, LED 제어

3. MQTT 설정


MQTT_BROKER = "172.30.1.100"
MQTT_PORT = 1883
MQTT_USERNAME = "ioehub"
MQTT_PASSWORD = "password"
MQTT_PUBLISH_TOPIC = "ioehub/mcp/command"
MQTT_SUBSCRIBE_TOPIC = "ioehub/mcp/response"



4. 구현된 기능

`4.1 온도 측정 (`ioehub_mqtt_get_temperature`)`



- 설명: MQTT를 통해 온도 센서에서 현재 온도 데이터를 읽어옵니다.
- 반환 값: 현재 온도(섭씨)를 문자열로 반환
- 기본 핀: 13번

`4.2 LED 제어 (`ioehub_mqtt_set_led`)`



- 설명: MQTT를 통해 지정된 핀의 LED 상태를 제어합니다.
- 파라미터:
  -

 (정수): LED 핀 번호 (기본값: 0)
  -

state

 (정수): LED 상태 (1=켜짐, 0=꺼짐)
- 반환 값: 작업 성공 여부(True/False)

5. 메시지 형식


5.1 온도 측정 요청

json
{
  "function": "ioehub_mqtt_get_temperature",
  "params": {
    "pin": 13
  }
}



5.2 온도 측정 응답

json
{
  "function": "ioehub_mqtt_get_temperature",
  "result": 26.5,
  "timestamp": "749817"
}



5.3 LED 제어 요청

json
{
  "function": "ioehub_mqtt_set_led",
  "params": {
    "pin": 0,
    "state": 1
  }
}



5.4 LED 제어 응답

json
{
  "function": "ioehub_mqtt_set_led",
  "result": true,
  "timestamp": "749820"
}



6. 작동 방식


1. 서버 초기화:
   - MQTT 클라이언트 생성 및 설정
   - 구독 토픽 설정 (ioehub/mcp/response)
   - FastMCP 인스턴스 생성

2. 연결 프로세스:
   - MQTT 브로커에 연결
   - 백그라운드 스레드에서 메시지 수신 대기

3. 함수 호출 처리:
   - MCP 도구 호출 시 해당 함수 실행
   - MQTT를 통해 요청 전송
   - 응답 대기 (최대 5초)
   - 결과 반환

4. 메시지 수신 처리:
   - 구독 토픽에서 메시지 수신
   - JSON 파싱 및 데이터 추출
   - 응답 플래그 설정

7. 오류 처리


- 응답 타임아웃: 5초 이내에 응답이 없으면 기본값 반환
- JSON 파싱 오류: 잘못된 형식의 메시지 처리
- MQTT 연결 오류: 연결 실패 시 오류 메시지 출력

8. 사용 방법


8.1 서버 실행

bash
python mcp_server.py



8.2 클라이언트에서 함수 호출

``python

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

IoEHub MQTT MCP 서버

1. 개요

1.1 구조도

1.2 Key Components:

Data Flow:

2. 시스템 구성

3. MQTT 설정

4. 구현된 기능

4.1 온도 측정 (ioehub_mqtt_get_temperature)

4.2 LED 제어 (ioehub_mqtt_set_led)

5. 메시지 형식

5.1 온도 측정 요청

5.2 온도 측정 응답

5.3 LED 제어 요청

5.4 LED 제어 응답

6. 작동 방식

7. 오류 처리

8. 사용 방법

8.1 서버 실행

8.2 클라이언트에서 함수 호출

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`4.1 온도 측정 (`ioehub_mqtt_get_temperature`)`

`4.2 LED 제어 (`ioehub_mqtt_set_led`)`