SMARTTHINGS HUB 사용자 전용 · ANDROID · LOCAL PROXY

SmartThings 외부 연동,
서버 없이 앱 하나로

SmartThings 자동화는 기본적으로 외부 인터넷 연결이 차단돼 있습니다. EdgeBridge는 그 연결을 대신 중계해주는 도구인데, 원래는 서버(라즈베리파이, NAS 등) 세팅이 필요해 시도조차 못 한 분들이 많았습니다. AEB는 그 서버 역할을 안드로이드 앱 하나로 대신합니다. 거기에 SmartThings MCP(AI가 SmartThings를 직접 다루는 연결 도구)가 내장돼 있어, AI가 SmartThings Agent로 동작하며 자연어로 집 전체를 제어하는 것도 됩니다.

🎯 그래서 AEB로 무엇을 할 수 있나요?

외부 클라우드 API 연동부터 자연어 음성 자동화까지 — 핵심 활용을 4가지로 정리했습니다.

🎯 예를 들면 이런 것들이 됩니다
서버 없이 간단히 — Tesla, Notion, Google Calendar, OpenAI 등 외부 API를 SmartThings 자동화에 연결. 예전엔 서버 세팅이 필요했는데, 이제 앱 설치 하나로 끝납니다.

SmartThings Agent — AI에게 "지금 집에 켜진 거 뭐야?"라고 물으면 AI가 SmartThings를 직접 조회해 상황을 답변해줍니다. SmartThings 자동화에서 AI가 생성한 결과를 스피커로 방송할 수 있습니다.

🔌 외부 OpenAPI 자유 연동

Tesla 차량 상태, 날씨 API, 이메일 발송, OpenAI/Gemini 호출, Notion·Google Drive 기록 — Edge Driver가 마음껏 외부 클라우드 API를 호출할 수 있게 됩니다. 내가 원하는 그 어떤 자동화·연동이든 직접 만들어 볼 수 있어요.

🤖 SmartThings MCP × LLM 자동화 명령

AEB는 SmartThings MCP 클라이언트가 내장돼 있습니다. SmartThings 자동화나 Chat 탭에서 "거실 불 꺼줘", "에어컨 26도", "지금 집에 누가 있어?"처럼 자연어 명령을 LLM에 보내면, LLM이 알아서 적절한 MCP 도구를 골라 호출합니다. 빅스비에게 명령하기의 직접 만드는 버전이라 보시면 됩니다.

↗ 사용 가능한 SmartThings MCP 도구 목록 보기

↗ AEB 진화 5단계 — 개념 이해 (MCP·웹 서치·스킬·캐시)

📋 상태 요약 브리핑

"지금 집 상태 한 줄로 알려줘" 한 번으로 LLM이 디바이스 상태를 모아 자연어로 요약해 줍니다. 출근 전, 잠들기 전, 외출 후 도착 시 — 자동화에 걸어두면 정해진 시간에 알아서 브리핑해 줘요.

🔊 TTS 음성 방송

LLM 호출 결과를 SmartThings 디바이스의 TTS(스피커)로 바로 방송할 수 있습니다. "거실 보일러를 켰어요", "오늘 비 와요, 우산 챙기세요" 같은 응답이 음성으로 들립니다. 무음 자동화가 아니라 말하는 자동화가 됩니다.

💡 왜 만들었나요?
라즈베리파이·홈서버·NAS — Edge Driver를 외부 서비스와 연결하려면 어딘가 켜둘 서버가 필요한데, 막상 세팅이 만만치 않아 시도조차 못 해본 분들이 대다수였습니다. 그래서 안 쓰는 폰이나 셋탑박스에 앱 하나 깔면 끝나는 시나리오를 만들고 싶어 시작한 프로젝트입니다.
🪶
BUILT ON · ORIGINAL EDGEBRIDGE

이 프로젝트는 toddaustin07/edgebridge에서 시작됐습니다

AEB는 SmartThings Edge Driver 커뮤니티의 사실상 표준이 된 오픈소스 EdgeBridge — Todd Austin님의 toddaustin07/edgebridge 의 프로토콜·철학·엔드포인트 설계를 그대로 Android에 포팅한 재구현입니다. 기존 EdgeBridge용 Edge Driver들은 어떤 수정도 없이 AEB에 바로 붙습니다. 이 모든 것의 출발점이 된 원작자에게 깊이 감사드립니다.

toddaustin07/edgebridge 원본 저장소 보기

왜 필요한가요?

SmartThings 허브의 Edge Driver는 보안상 외부 인터넷에 직접 접근할 수 없습니다. AEB가 그 한계를 풀어줍니다.

⚠ 전제조건 — SmartThings Hub가 있어야 합니다
AEB는 SmartThings Hub(V3·V4·Station, 삼성 TV·냉장고 내장 허브 등) 사용자를 위한 도구입니다. 허브가 있어야 Edge Driver가 실행되고, AEB는 그 Edge Driver의 외부 통신을 대신 중계해줍니다. 허브가 없거나 SmartThings 클라우드 직결 디바이스(앱 안에서 클라우드로 바로 붙는 가전·플러그)만 쓰는 환경이라면 AEB는 필요하지 않습니다.

🔌 외부 API 호출

Edge Driver가 Tesla, OpenAI 등 외부 클라우드 서비스에 HTTP로 요청할 수 있게 해줍니다.

🏠 로컬 네트워크 전용

모든 트래픽은 사용자의 로컬 네트워크 안에서만 흐릅니다. 제작자 서버로 데이터를 전송하지 않습니다.

📡 mDNS 자동 탐색

Edge Driver가 mDNS로 AEB를 자동으로 찾아 붙습니다. IP 입력이 필요 없습니다.

🤖 LLM 에이전트

Claude · OpenAI · Gemini와 SmartThings MCP를 연결한 자율 에이전트 콘솔이 내장되어 있습니다.

📺 Android TV · 셋탑박스 = 최고의 선택

집에 굴러다니는 안드로이드 TV나 셋탑박스가 있다면 그게 곧 AEB의 가장 좋은 자리입니다. 폰을 한 대 희생할 필요가 없어요.

왜 TV·셋탑이 가장 잘 어울릴까요?
TV·셋탑은 늘 전원에 꽂혀 있고 유선 LAN을 쓸 수 있어 폰의 배터리·발열·절전 같은 제약이 처음부터 없습니다. AEB는 TV 모드를 자동 감지해 배터리 조건과 절전 검사도 통째로 면제하므로, 한 번 켜두고 잊으셔도 됩니다. 새 폰을 사거나 메인 폰 한 대를 희생할 필요가 없어요.

🔌 상시 전원

TV·셋탑은 항상 전원에 연결돼 있어 배터리 마모·관리 부담이 없습니다. 충전기 빠질 일도, 사이클 닳을 일도 없습니다.

🌐 유선 LAN

이더넷 우선이라 WiFi 끊김·로밍 걱정이 없습니다. mDNS 탐색도 가장 안정적이고, IP가 거의 안 바뀝니다.

♻️ 안 쓰는 박스 재활용

구형 셋탑박스, 처박혀있던 안드로이드 TV — 새 기기 살 필요 없이 그대로 24시간 SmartThings 외부 통신 서버로 부활합니다.

📲 메인 폰에서 세팅 끝낸 뒤 TV로 한 번에 옮기는 법 →

어떻게 동작하나요?

두 가지 흐름으로 동작합니다.

① 외부 서비스 연동

SmartThings Hub
SmartThings 자동화
외부 인터넷 차단됨
로컬 네트워크
AEB (Android)
폰 · 태블릿 · TV
인터넷
외부 서비스
Tesla · OpenAI · Notion 등

② AI 에이전트로 제어

자연어 명령
AEB 내장 AI 에이전트
Claude · ChatGPT · Gemini
SmartThings MCP
AI 제어 도구
디바이스 조회 · 제어
SmartThings
디바이스 실행
조명 · 에어컨 · 센서 등

주요 기능

한 번 설치하면 손댈 필요 없도록 만들어진 24시간 로컬 브릿지입니다.

24시간 무중단 · TV 모드 자동

Foreground Service + WakeLock으로 앱이 종료되지 않고, WiFi 끊김도 자동 감지·복구합니다. Android TV·셋탑은 자동 인식되어 배터리/절전 조건이 면제되므로 더 안정적입니다.

🔋 배터리 보호

배터리가 10% 미만으로 떨어지면 자동 중지해 폰을 보호합니다. 충전 중에는 항상 동작 — 폰을 망가뜨리지 않는 운용 정책이 기본 내장.

🚀 자동 시작

폰 부팅 시 자동 시작 + 앱 업데이트 후 자동 재시작. 한 번 설정하면 잊고 살 수 있습니다.

🔁 toddaustin07/edgebridge 기반

toddaustin07/edgebridge의 프로토콜을 Android로 그대로 포팅. 기존 EdgeBridge용 Edge Driver들이 수정 없이 그대로 붙습니다.

🤖 LLM 에이전트 내장

Claude · OpenAI · Gemini와 SmartThings MCP를 연결해 자연어로 집을 제어할 수 있습니다.

시작하기

처음이세요? 6단계만 따라오시면 끝납니다.

🚀

무작정 따라하기

설치부터 자동화 활용까지 — 6단계로 끝나는 첫 세팅 가이드.
두더싱 문의 시에는 "퀵스타트 N-M에서 막혔다"고 한 줄로 짚어주세요.

시작하기 →

세부 가이드가 필요하시면 상단 메뉴의 설치 / 사용법 참조.

커뮤니티에서 같이 하기

설치·연동·트러블슈팅은 두더싱 — 스마트싱스 네이버 카페(비공식)에서 활발하게 이뤄지고 있습니다.

두더싱 — 스마트싱스 네이버 카페(비공식)

SmartThings 사용자들이 모이는 한국 최대 커뮤니티입니다. AEB 사용 사례, 새 Edge Driver 소식, 자동화 팁을 가장 빠르게 만나볼 수 있습니다.

N 두더싱 가입하기