allocnode/oh-my-sage

Mijia Automation Geek Edition AI 에이전트 - 자연어를 사용해 Mijia Geek을 위한 복잡한 자동화 규칙 생성

Oh My Sage는 도구 기반 AI 에이전트로, 자연어 대화를 통해 Xiaomi Mijia Automation Geek Edition 규칙을 생성하고 관리하는 데 도움을 줍니다.

---

✨ 핵심 기능

• 🤖 에이전트 루프 - 일회성 반응이 아닌 지속적으로 작동하는 사고-행동 사이클
• 🛠️ 도구 기반 기능 - 모든 기능이 도구를 통해 구현되며 유연하고 확장 가능합니다
• 💭 가시적으로 생각하기 - 에이전트가 무엇을 하는지 이해할 수 있도록 사고 과정을 출력합니다
• 💡 여러 솔루션 제안 - 선택할 수 있는 다양한 구현 옵션을 제공합니다
• ✅ 확인 후 실행 - 중요한 작전 전에 확인 받기
• 🔄 스트리밍 출력 - 처리 절차의 실시간 표시
• 📐 자동 레이아웃 - 프로세스를 명확히 표시하기 위해 규칙 노드를 자동으로 배치합니다
• 🔌 MCP 지원 - 모델 컨텍스트 프로토콜을 통해 AI 프로그래밍 어시스턴트에 통합됨

---

🚀 빨리 시작하세요

두 가지 사용 모드, 하나를 선택하세요:

환경 요구사항 :Node.js 18.17+이며, Mijia Geek Edition 게이트웨이와 동일한 LAN에 있어야 합니다. Windows 네이티브 상주 스크립트는 Node.js 20.6+가 필요하며, Docker 이미지는 Node.js 22를 포함합니다.

MCP 방법 (한 줄 명령 설치)

AI 어시스턴트의 MCP 설정에서 Claude Desktop, Cursor 등과 같은 클라이언트는 mcpServers 형식으로 클라이언트를 추가하고, GATEWAY_URL를 게이트웨이 주소로 변경하세요:

설정 후 대화를 통해 직접 사용하세요:

• “Mi Home 기기 확인 도와줘”
• “매일 밤 8시에 거실 조명을 끄는 자동 규칙을 만드세요.”

⚠️ > 스킬에 대하여: 자동화 규칙을 생성/수정하려면 AI 어시스턴트가 mijia-automation 스킬을 읽어야 하며, 아래 2단계 참조.

다른 클라이언트를 위한 구성 형식 및 로컬 상주/프라이빗 서버 배포(게이트웨이를 통해 한 번 로그인; 클라이언트 재시작 후 로그인 코드 재입력 필요 없음), deploy/README.md를 참조하세요.

웹 메서드 (한 줄 명령 시작)

http://localhost:3000에 접속하여 사용을 시작하세요. 추가 설치 없이 웹을 통해 저장소에서 직접 스킬을 읽을 수 있습니다.

---

📖 상세한 문서

🔌 MCP 서버 (권장 개발 시나리오)

모델 컨텍스트 프로토콜을 통해 오-마이-세이지를 AI 프로그래밍 어시스턴트에 통합하세요.