MM

mcp2everything/mcp2mqtt

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

371 stars 60 forks 품질 68 트렌드 19MIT

MCP 프로토콜을 MQTT 프로토콜로 변환함으로써, 이 프로젝트는 강력한 대형 언어 모델(LLM)을 활용해 스마트 홈, 로봇 또는 기타 하드웨어 장치를 쉽게 제어할 수 있게 합니다.

개요

mcp2mqtt는 IoT 기기를 AI 대형 모델과 연결하여 모델 컨텍스트 프로토콜(MCP)과 MQTT 프로토콜을 통해 물리적 세계와 AI 대형 모델을 원활하게 연결하는 프로젝트입니다. 최종 구현: - 자연어로 하드웨어 장치를 제어함 - AI가 실시간으로 반응하고 물리적 매개변수를 조정함 - 장치가 복잡한 명령을 이해하고 실행할 수 있도록 - MQTT를 통한 장치 간 상호 연결 가능 - - MQTT 프로토콜 발행/구독 모드 지원 - 다양한 MQTT 서버(예: Mosquitto, EMQ X 등) 지원 - QoS 품질 보증 지원 - 주제 필터링 및 메시지 라우팅 지원 - 실시간 상태 모니터링 및 오류 처리 - - 모델 컨텍스트 프로토콜에 대한 완전한 지원 - 자원 관리 및 도구 호출 - 유연한 프롬프트 시스템 - MQTT를 통한 명령 게시 및 응답 1. PWM 제어: - 명령: PWM {값} - 예시: - PWM 100 (최대) - PWM 0 (오프) - PWM 50 (50%) - 응답: CMD PWM {값} OK 2. LED 제어: - 명령: LED {상태} - 예시: - LED 켜짐 - LED 꺼짐 - 응답: CMD LED {상태} OK mcp2MQTT는 MCP 프로토콜을 구현하는 모든 클라이언트와 MQTT 프로토콜을 지원하는 IoT 기기를 지원합니다: 설치 스크립트는 다음 단계를 자동으로 수행합니다: - 시스템 환경 점검 - 필요한 의존성 설치 - 기본 설정 파일 생성 - Claude 데스크톱 에디션 구성 (설치 시) 주로 UV 툴에 의존하기 때문에, Python, UV, Claude 또는 Cline을 설치하면 작동합니다.

개요(AI 번역)

영어 | 중국어 간체

자연어로 제어되는 하드웨어는 사물인터넷의 새로운 시대를 열었습니다

시스템 아키텍처

MCP2MQTT 시스템 아키텍처 다이어그램

워크플로우

MCP2MQTT 워크플로우차트

프로젝트 비전

mcp2mqtt는 IoT 기기를 AI 대형 모델에 연결하여 모델 컨텍스트 프로토콜(MCP)과 MQTT 프로토콜을 통해 물리적 세계와 AI 대형 모델을 원활하게 연결하는 프로젝트입니다. 최종 구현:

  • 자연어로 하드웨어 장치를 제어하기
  • AI가 실시간으로 반응하여 물리적 매개변수를 조정합니다
  • 복잡한 명령을 이해하고 실행할 수 있는 능력을 장비에 장착하세요
  • MQTT 프로토콜을 통한 장치 간 상호 연결을 가능하게 함

주요 특징

  • 지능형 MQTT 통신

  • MQTT 프로토콜의 게시/구독 모드를 지원합니다

  • Mosquitto, EMQ X 등 다양한 MQTT 서버를 지원합니다.

  • QoS 서비스 품질 보증 지원

  • 주제 필터링 및 메시지 라우팅 지원

  • 실시간 상태 모니터링 및 오류 처리

  • MCP 프로토콜 통합

  • 모델 컨텍스트 프로토콜에 대한 완전한 지원

  • 리소스 관리 및 툴 호출 지원

  • 유연한 프롬프트 시스템

  • MQTT를 통한 명령 발급 및 응답 구현

구성 지침

MQTT 구성

명령 구성

MQTT 명령 및 응답

명령 형식

명령어는 간단한 텍스트 형식을 사용합니다:

  1. PWM 제어:
  • 명령: PWM {值}
  • 예시:
  • PWM 100(최대치)
  • PWM 0(폐쇄)
  • PWM 50(50%)
  • 응답: CMD PWM {值} OK
  1. LED 제어:
  • 명령: LED {状态}
  • 예시:
  • LED on (오픈)
  • LED off(닫음)
  • 응답: CMD LED {状态} OK
  1. 장비 정보:
  • 명령: INFO
  • 응답: CMD INFO {设备信息}

오류 응답

오류가 발생하면 응답 형식은 다음과 같습니다: ERROR: {错误信息}

지원 클라이언트

mcp2MQTT는 MCP 프로토콜을 구현하는 모든 클라이언트와 MQTT 프로토콜을 지원하는 IoT 기기를 지원합니다:

클라이언트 유형 기능 지원 설명
클로드 데스크탑 완전 지원 추천, 모든 MCP 기능 지원
계속 전면 지원 훌륭한 개발 도구 통합
클라인 리소스 + 도구 여러 AI 제공업체 지원
MQTT 장치 게시/구독 모든 MQTT 프로토콜을 지원하는 IoT 장치

빨리 시작하세요

1. 설치

윈도우 사용자

다운로드 install.py

macOS 사용자

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

설치

uvx mcp2mqtt
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "mcp2mqtt": { "command": "uvx", "args": [ "mcp2mqtt" ] } } }