HomeButler: API 키 없이 Claude에서 홈랩 서버를 관리하는 MCP 서버

HomeButler는 Claude가 API 키 없이도 홈랩 서버를 직접 관리할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. 이 도구는 로컬에서 실행되며 모든 작업을 사용자의 네트워크 내에서 유지합니다.

주요 기능 및 명령어

소스는 Claude가 HomeButler로 수행할 수 있는 몇 가지 구체적인 작업을 보여줍니다:

• "Install uptime-kuma" → 사전 점검을 수행하고 애플리케이션을 배포한 후 완료를 확인합니다
• "How are my servers?" → 모든 노드의 상태를 제공합니다
• "Restart nginx" → 재시작 명령을 실행합니다
• "Uninstall vaultwarden" → 데이터를 보존하면서 애플리케이션을 중지합니다

설정 구성

설정에는 다음 JSON을 사용하여 MCP 구성에 HomeButler를 추가해야 합니다:

{
  "mcpServers": {
    "homebutler": {
      "command": "npx",
      "args": ["-y", "homebutler@latest"]
    }
  }
}

이 도구는 Claude Code를 사용하여 구축되었으며, 이는 개발 과정 전반에 걸쳐 아키텍처 결정, 도구 핸들러 작성 및 에지 케이스 디버깅을 지원했습니다.

HomeButler는 https://github.com/Higangssh/homebutler에서 GitHub에서 이용할 수 있습니다.