homebutler

概述

HomeButler 是一个用 Go 编写的综合家庭实验室管理工具，它提供对服务器资源的结构化访问，无需 SSH shell。它通过简洁的 CLI 界面展示系统信息、Docker 容器状态、端口映射和应用清单。MCP 实现允许 AI 代理检查服务器健康状态、诊断问题和管理部署，而无需完全系统访问。该工具专注于通过 JSON 格式输出和自动化报告提供可操作的见解。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• status

  Check server status including CPU, memory, disk, and uptime

  试试:Show me the server status试试:What's the current CPU and memory usage?
• docker_list

  List running Docker containers

  试试:List all running Docker containers试试:Which containers are currently active?
• inventory_scan

  Scan server inventory including containers, ports, and service topology

  试试:Map my server's containers and ports试试:Show me the service topology
• report

  Generate a health report with change summary since last snapshot

  试试:Generate a health report for my server试试:What changes have occurred since last check?
• install

  Install self-hosted applications like Uptime Kuma or Jellyfin

  试试:Install Uptime Kuma on my server试试:Deploy Jellyfin with media directory
• backup_drill

  Verify backups can be restored by testing them in isolation

  试试:Test if my backup can be restored试试:Verify the Uptime Kuma backup is valid
• watch

  Monitor services for crashes and automatically detect flapping

  试试:Start monitoring nginx for crashes试试:Check if any services are flapping
• doctor

  Run diagnostic checks for resource pressure, stopped containers, and backup hygiene

  试试:Run a health check on my server试试:Check for any system issues
• serve

  Start the web dashboard for visual monitoring

  试试:Start the web dashboard试试:Show me the web interface

说明：Tool names inferred from CLI command examples in the README. Some tools may have different MCP signatures than their CLI counterparts.

可对比工具

安装

# 一键安装（自动检测操作系统/架构）
curl -fsSL https://raw.githubusercontent.com/Higangssh/homebutler/main/install.sh | sh

# 或通过 Homebrew 安装
brew install Higangssh/homebutler/homebutler

# 交互式设置 — 几秒钟内添加您的服务器
homebutler init

{
  "mcpServers": {
    "homebutler": {
      "command": "homebutler",
      "args": ["mcp"]
    }
  }
}

FAQ

HomeButler 与其他家庭实验室工具有何不同？

HomeButler 优先考虑命令行界面，支持 JSON 格式，不需要持久守护进程或数据库。它提供适合自动化和 AI 交互的结构化输出，不像以仪表板为中心的工具。

MCP 服务器功能如何工作？

HomeButler 通过 MCP 协议暴露服务器信息，允许 AI 助手访问系统状态、容器信息、端口映射并运行诊断，而无需 SSH 访问。

Hacker News 讨论

开发者社区最近的相关讨论。

• Show HN: Homebutler – AI manages your homelab without getting shell access▲ 4💬 1
  帖子 by swq115 · 2026-04-07
• Show HN: Homebutler – Manage multiple servers from chat, single binary▲ 4
  帖子 by swq115 · 2026-03-02
• Show HN: I replaced Portainer and btop with a single Go binary for my homelab▲ 3💬 2
  帖子 by swq115 · 2026-03-04

homebutler 对比