피드로 돌아가기
Show GN: HomeButler – 홈서버를 챙겨주는 작은 집사 CLI
GeekNewsGeekNews
Infrastructure

Show GN: HomeButler – 홈서버를 챙겨주는 작은 집사 CLI

Go Single Binary 기반의 MCP 연동 홈서버 통합 관리 CLI 설계

swq1152026년 4월 29일2intermediate

Context

홈서버 운영 시 개별 명령어로 분산된 상태 확인 및 백업 검증의 번거로움 발생. 단순 설치보다 지속적인 유지보수와 상태 추적을 위한 통합 관리 인터페이스의 필요성 증대.

Technical Solution

  • 의존성 제거를 위한 Go Single Binary 기반의 무상태(Stateless) CLI 구조 설계
  • AI 도구와의 안전한 연동을 위해 Raw Shell 권한 대신 MCP Server를 통한 구조화된 명령 노출
  • Baseline Snapshot 기반의 상태 비교 로직을 통한 변경 사항 탐지 및 리포트 생성
  • 스냅샷 유지 개수를 30개로 제한하여 리소스 오버헤드를 최소화한 데이터 관리
  • Backup Drill 기능을 통한 실제 복구 가능성 검증 프로세스 내재화
  • JSON 출력 지원을 통한 타 도구와의 파이프라인 연동성 확보

1. AI Agent 연동 시 보안을 위해 전체 Shell 권한 대신 제한된 API/CLI 명령셋을 제공하는 MCP 구조 검토

2. 상태 모니터링 설계 시 절대값보다 Baseline 대비 변경분을 추적하는 Snapshot 방식 적용

3. 백업 전략 수립 시 단순 저장 여부가 아닌 실제 복구 테스트(Drill) 단계를 자동화 프로세스에 포함

원문 읽기