본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

Sonoff MCP Server

eWeLink 클라우드를 통해 Sonoff 릴레이를 켜고 끄며 온도조절기를 설정하는 작은 자체 호스팅 서버로, Claude 등 원격 클라이언트용입니다.

리뷰어: ReviewRamble editors · 업데이트

설치 문서 무료

이 페이지 공유:XLinkedInFacebookRedditWhatsApp이메일

평점

2.9/5

Claude에서 실제로 Sonoff 기기를 켜고 끄는 깔끔한 개인 프로젝트지만, 공유 비밀번호 하나, 읽기 전용 모드 부재, 라이선스 부재 때문에 그대로 설치할 물건이 아니라 출발점입니다.

Sonoff MCP Server의 개요

Sonoff MCP Server는 GitHub 사용자 mrkutin이 만든 것으로, MCP 클라이언트가 eWeLink Cloud API(CoolKit Open Platform v2)를 통해 Sonoff 기기를 제어하게 합니다. 도구는 list_devices, get_device, switch_device, get_sensor_data, set_thermostat 5개입니다. 기기는 대소문자를 구분하지 않는 부분 이름으로 지정하며, 서버는 각 기기의 eWeLink 매개변수를 읽어 스위치, 온도조절기, 센서를 하나의 모델로 다룹니다. README에는 THR316D, MINIR4, SV, BASICR2가 나옵니다.

Python 3.12 FastMCP 서버로, 자체 HTTPS 리버스 프록시 뒤에서 Docker Compose로 실행하므로 claude.ai 같은 호스팅 클라이언트도 접속할 수 있고, 클라이언트와 서버 사이에는 OAuth 2.0과 PKCE를 씁니다. 작성자는 이를 AI 전화 비서의 기기 계층으로 사용합니다. 코드에는 2026년 2월부터 7월까지 커밋 9개가 있으며, 저장소는 2026년 11월 13일 GitHub에 공개됐고 스타, 릴리스, 라이선스 파일이 없습니다.

Sonoff MCP Server 설치 방법

git clone https://github.com/mrkutin/sonoff-mcp && cp .env.example .env && docker compose up -d

Sonoff MCP Server, 쓸 만한 가치가 있습니까?

Sonoff에는 제조사 MCP 서버가 없고, 우리가 찾은 이전 커뮤니티 eWeLink 서버 991glasses/ewelink-mcp-server는 2025년 6월 이후 커밋이 없습니다. 이 서버는 현재 관리되고 있으며 작습니다. 도구 5개로 기기 목록을 보고, 온도와 습도를 읽고, 기기를 켜거나 끄고, 임계값과 함께 온도조절기를 난방, 냉방, 제습, 끔으로 설정합니다. 온도조절기를 켜거나 끄면 자동 모드도 해제됩니다. Sonoff 릴레이는 램프부터 히터나 펌프까지 무엇에든 연결될 수 있으므로, switch_device의 무게는 반대편에 연결된 기기에 달려 있습니다.

모든 명령은 클라우드를 거칩니다. 경로는 AI 클라이언트, 사용자의 서버, eu, us, as, cn 중 한 리전의 eWeLink 클라우드, 그리고 기기입니다. 네트워크 안의 기기와 직접 통신하는 부분이 없으므로 인터넷이나 eWeLink가 다운되면 명령이 실패하고, 기기 데이터는 eWeLink 개인정보처리방침의 적용을 받습니다. 서버 소유자가 설정 페이지에서 eWeLink 계정을 한 번 승인하면, 서버는 그 계정의 토큰을 자신이 발급한 MCP 토큰과 함께 Docker 볼륨의 파일에 0600 권한으로 저장합니다.

약점은 접근 제어입니다. 클라이언트 로그인은 PKCE를 쓰는 진짜 OAuth지만, 로그인 페이지는 서버 환경에 설정된 클라이언트 ID와 비밀값 한 쌍만 요구하므로 이를 아는 사람은 eWeLink 계정의 모든 기기를 제어합니다. 사용자, 범위, 읽기 전용 도구는 없습니다. 선택 사항인 MCP_API_KEY는 만료되지 않는 bearer 토큰으로 작동하며, 기계 간 호출을 위해 추가됐습니다. 코드에는 타이밍 공격에 안전한 비교, HTML 이스케이프, 리전 허용 목록 등 신경 쓴 흔적이 있지만 외부 검토를 받은 적이 없고, 저장소에 테스트가 없으며, 작성자는 한 명뿐입니다.

라이선스가 없다는 점은 코드만큼 중요합니다. 라이선스가 없으면 작성자는 복사나 수정 권리를 주지 않은 것이므로, 기업이라면 이를 기반으로 만들기 전에 먼저 문의해야 합니다. Sonoff 기기 몇 대를 가진 사람에게는 신중하게 만든 원격 MCP 커넥터의 읽기 쉬운 예시입니다. 대부분에게는 SonoffLAN 통합과 자체 MCP 서버를 갖춘 Home Assistant가 로컬 제어와 더 세밀한 권한을 줍니다.

제 역할을 하는 곳

  • Sonoff THR316D 온도조절기와 스마트 릴레이 2개를 가진 개발자

    퇴근길에 Claude로 난방을 켜고 싶다

    dev.ewelink.cc에서 무료 개인 앱을 등록하고, HTTPS 프록시 뒤에서 컨테이너를 실행하고, eWeLink를 한 번 승인한 뒤 서버를 Claude 커넥터로 추가합니다. 설정에 저녁 한나절은 걸리며 호스팅 버전은 없습니다.

  • 음성 비서나 전화 비서를 만드는 메이커

    LLM에 작고 안전한 기기 동작 세트를 주고 싶다

    작성자의 전화 비서처럼 MCP_API_KEY로 5개 도구를 호출합니다. 이 키는 만료되지 않으므로 직접 교체하고, 중요한 부하에 연결된 릴레이는 서버가 쓰는 eWeLink 계정에서 빼 두십시오.

도입 전 확인할 점

설정
dev.ewelink.cc에서 앱을 등록해 앱 ID와 비밀값을 받고, .env.example을 .env로 복사해 이 값들과 MCP 클라이언트 ID, 비밀값, 공개 URL을 넣습니다. TLS 리버스 프록시 뒤에서 docker compose up -d를 실행한 다음 /ewelink/setup을 한 번 열어 eWeLink 계정을 승인합니다.
연동
도구 5개: list_devices, get_device, switch_device, get_sensor_data, set_thermostat. Claude Code, claude.ai 등 원격 MCP 클라이언트용 스트리밍 HTTP. 상위 연결은 eWeLink Cloud API v2뿐이며 LAN 제어나 eWeLink CUBE는 지원하지 않습니다.
데이터와 개인정보
eWeLink 앱 비밀값, 계정의 OAuth 토큰, 자체 MCP 토큰을 Docker 볼륨에 보관합니다(토큰 파일은 0600으로 기록). 기기 이름, 상태, 측정값은 eWeLink 클라우드를 거쳐 AI 제공업체로 갑니다. MCP 클라이언트 비밀값이나 MCP_API_KEY를 가진 사람은 계정의 모든 기기를 켜고 끌 수 있습니다.
대규모 사용 시 비용
호스팅 비용 외에는 무료입니다. eWeLink 개인 개발자 등급은 무료지만 OAuth 전용이고 API 호출 수가 제한되며 안정성 보장이 없습니다. 상업적 사용에는 eWeLink 유료 엔터프라이즈 등급이 필요하며 가격은 문의해야 합니다.
제한
서버당 eWeLink 계정 하나, 공유 클라이언트 자격 증명 하나입니다. 오프라인 기기에는 2초 간격으로 두 번 재시도한 뒤 오류를 냅니다. MCP 액세스 토큰은 24시간 유효하고 리프레시 토큰을 지원하지 않으므로 클라이언트는 매일 다시 로그인합니다.

좋은 점

  • OAuth 2.0과 PKCE로 호스팅 클라이언트와 연동
  • 스위치와 온도조절기를 이름으로 검색
  • 오프라인이 된 기기에 대한 명령 재시도
  • 짧고 읽기 쉬운 코드, 이력에 보안 수정 포함

아쉬운 점

  • 공유 클라이언트 비밀값 하나로 모든 기기 제어
  • 읽기 전용 모드, 범위, 기기별 제한 없음
  • 클라우드 전용이라 eWeLink나 인터넷이 다운되면 실패
  • 아직 라이선스, 릴리스, 테스트, 다른 사용자 없음

추천 대상

eWeLink에 Sonoff 기기를 둔 개발자 중 작고 읽기 쉬운 원격 MCP 커넥터를 자기 용도에 맞게 고쳐 쓰고 싶은 사람.

Sonoff MCP Server 대안

Sonoff MCP Server: 자주 묻는 질문

Sonoff MCP Server, 쓸 만한 가치가 있습니까?
Claude에서 실제로 Sonoff 기기를 켜고 끄는 깔끔한 개인 프로젝트지만, 공유 비밀번호 하나, 읽기 전용 모드 부재, 라이선스 부재 때문에 그대로 설치할 물건이 아니라 출발점입니다. 평점은 5점 만점에 2.9점입니다.
Sonoff MCP Server의 가격은 얼마입니까?
무료로 실행할 수 있지만 소스에 라이선스 파일이 없습니다. eWeLink 개인 개발자 등급은 무료이며 API 호출 수가 제한됩니다.
Sonoff MCP Server의 단점은 무엇입니까?
공유 클라이언트 비밀값 하나로 모든 기기 제어; 읽기 전용 모드, 범위, 기기별 제한 없음; 클라우드 전용이라 eWeLink나 인터넷이 다운되면 실패; 아직 라이선스, 릴리스, 테스트, 다른 사용자 없음.
Sonoff MCP Server에 적합한 사람은 누구입니까?
eWeLink에 Sonoff 기기를 둔 개발자 중 작고 읽기 쉬운 원격 MCP 커넥터를 자기 용도에 맞게 고쳐 쓰고 싶은 사람.
팀이나 프로덕션 환경에서 Sonoff MCP Server의 비용은 얼마입니까?
호스팅 비용 외에는 무료입니다. eWeLink 개인 개발자 등급은 무료지만 OAuth 전용이고 API 호출 수가 제한되며 안정성 보장이 없습니다. 상업적 사용에는 eWeLink 유료 엔터프라이즈 등급이 필요하며 가격은 문의해야 합니다.
Sonoff MCP Server에 회사 데이터를 맡겨도 안전합니까?
eWeLink 앱 비밀값, 계정의 OAuth 토큰, 자체 MCP 토큰을 Docker 볼륨에 보관합니다(토큰 파일은 0600으로 기록). 기기 이름, 상태, 측정값은 eWeLink 클라우드를 거쳐 AI 제공업체로 갑니다. MCP 클라이언트 비밀값이나 MCP_API_KEY를 가진 사람은 계정의 모든 기기를 켜고 끌 수 있습니다.
Sonoff MCP Server의 가장 좋은 대안은 무엇입니까?
저희가 리뷰한 것 중 가장 가까운 대안은 Home Assistant MCP Server, HA-MCP 및 Aqara MCP Server입니다.

답변 확인일: 2026년 11월 16일.