AI 개발자 도구
sharkclean-mcp
SharkClean / SharkNinja 로봇 청소기용 MCP 서버로, 모든 MCP 클라이언트를 통해 에이전트 기반 제어가 가능합니다: 자연어로 청소 시작, 특정 방 청소, 도킹, 상태 확인 등을 실행할 수 있습니다.
sharkclean-mcp
sharkclean-mcp란?
sharkclean-mcp는 AI 에이전트가 자연어 명령을 통해 SharkClean 로봇 청소기를 제어할 수 있게 해주는 MCP 서버입니다. SharkNinja의 클라우드 백엔드와 통신하여 청소 시작, 특정 방 청소, 도킹, 상태 모니터링 등을 수행합니다.
sharkclean-mcp 사용 방법
- 1저장소를 클론하고 해당 디렉토리로 이동합니다.
- 2'uv sync'를 실행하여 종속성을 설치합니다.
- 3.env.example을 .env로 복사하고 SharkClean 앱의 이메일과 비밀번호를 추가합니다.
- 4'uv run shark-mcp-auth'를 실행하여 일회성 브라우저 로그인을 수행합니다.
- 5'uv run shark-mcp-doctor'로 설정을 확인합니다.
- 6제공된 명령어를 사용하여 MCP 클라이언트(예: Claude Code 또는 Claude Desktop)에 MCP 서버를 등록합니다.
sharkclean-mcp 주요 기능
- 계정의 로봇 목록 표시
- 실시간 상태 확인 (청소 중/일시 중지/도킹, 배터리, 충전 중, 오류)
- 선택적 전원 모드로 전체 집 청소 시작
- 로봇 지도에서 방 목록 표시
- 특정 방 청소
- 청소 일시 중지, 재개 또는 중지
- 로봇을 도크로 반환
- 전원 모드 설정 (에코/보통/최대)
- 소리로 로봇 위치 찾기
sharkclean-mcp 사용 사례
- AI 어시스턴트를 통해 최대 전력 청소 시작
- 자연어로 주방과 거실 청소
- 로봇 상태 및 배터리 잔량 확인
- 청소 후 로봇을 도크로 보내기
- 스크립트 또는 크론 작업에서 청소 작업 자동화
sharkclean-mcp 가격 및 무료 크레딧
sharkclean-mcp의 가격 모델은 무료입니다.
sharkclean-mcp 장점과 단점
장점
- 레거시 SDK에서 지원되지 않는 최신 로봇과 호환됨
- AI 통합에 MCP 프로토콜 사용
- 명확한 문서를 갖춘 오픈소스
- 다중 로봇 계정 지원
단점
- 비공식, SharkNinja와 제휴되지 않음
- Auth0 제한으로 인해 일회성 브라우저 로그인 필요
- Auth0 토큰이 만료되어 재인증이 필요할 수 있음
- 방 지정은 로봇의 완성된 지도가 필요함
sharkclean-mcp은 어떤 용도에 가장 적합한가요?
- SharkClean 청소기를 AI 워크플로우에 통합하는 개발자
- MCP 호환 클라이언트를 사용하는 홈 오토메이션 애호가
- 최신 SharkNinja 로봇 청소기 사용자