Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring
TypeScript diagramhomelabhomelab-infrastructure-observabilitynetworkproxmox-veself-hostedzigbeezwavezwave-js
feat(scripts): add LXC/bare-metal MCP install script
Pouzor77159ce1cdbb
diff --git a/README.md b/README.mdindex 8b5ada9..592376c 100644--- a/README.md+++ b/README.md@@ -223,6 +223,10 @@ docker compose up -d mcp# MCP server is now listening on http://<your-homelab-ip>:8001```+> **Proxmox LXC / bare-metal (no Docker):** run `sudo bash scripts/lxc-mcp-install.sh`.+> Installs a `homelable-mcp` systemd service, prompts for `MCP_API_KEY` / `MCP_SERVICE_KEY`+> (auto-generated if you press Enter), and skips prompts if `mcp/.env` already exists.+**3. Configure your AI client:****Claude Code** — run this command in your terminal:diff --git a/scripts/lxc-mcp-install.sh b/scripts/lxc-mcp-install.shnew file mode 100755index 0000000..957c5a4--- /dev/null+++ b/scripts/lxc-mcp-install.sh@@ -0,0 +1,153 @@+#!/bin/bash+# Install / enable the Homelable MCP server as a systemd service on a+# Proxmox LXC (or any Debian/Ubuntu host) where Docker is NOT used.+#+# Idempotent: re-running is safe. If mcp/.env already exists, the script+# keeps it untouched and only refreshes the venv + systemd unit.+#+# Usage (run as root inside the LXC):+# bash scripts/lxc-mcp-install.sh+# INSTALL_DIR=/srv/homelable bash scripts/lxc-mcp-install.sh+set -euo pipefail++INSTALL_DIR="${INSTALL_DIR:-/opt/homelable}"+SERVICE_USER="${SERVICE_USER:-homelable}"+SERVICE_NAME="homelable-mcp"+MCP_PORT="${MCP_PORT:-8001}"+DEFAULT_BACKEND_URL="http://127.0.0.1:8000"++log() { printf '\033[1;36m==>\033[0m %s\n' "$*"; }+warn() { printf '\033[1;33m!!\033[0m %s\n' "$*" >&2; }+fail() { printf '\033[1;31mxx\033[0m %s\n' "$*" >&2; exit 1; }++# --- preflight ---------------------------------------------------------------+[[ $EUID -eq 0 ]] || fail "Run as root (sudo bash $0)."++MCP_DIR="$INSTALL_DIR/mcp"+[[ -d "$MCP_DIR" ]] || fail "Not found: $MCP_DIR — clone the repo to $INSTALL_DIR first, or set INSTALL_DIR=..."+[[ -f "$MCP_DIR/requirements.txt" ]] || fail "Missing $MCP_DIR/requirements.txt — repo layout unexpected."++if ss -ltn 2>/dev/null | awk '{print $4}' | grep -qE "[:.]${MCP_PORT}$"; then+ warn "Port $MCP_PORT already in use. If it's a previous $SERVICE_NAME instance this is fine; otherwise abort and free the port."+fi++# --- packages ----------------------------------------------------------------+log "Installing OS dependencies (python3-venv, curl)"+apt-get update -qq+DEBIAN_FRONTEND=noninteractive apt-get install -y -qq python3 python3-venv python3-pip curl >/dev/null++# --- service user ------------------------------------------------------------+if ! id -u "$SERVICE_USER" >/dev/null 2>&1; then+ log "Creating service user '$SERVICE_USER'"+ useradd --system --home "$INSTALL_DIR" --shell /usr/sbin/nologin "$SERVICE_USER"+fi++# --- .env --------------------------------------------------------------------+ENV_FILE="$MCP_DIR/.env"+if [[ -f "$ENV_FILE" ]]; then+ log ".env already present at $ENV_FILE — keeping user values (prompts skipped)"+else+ [[ -f "$MCP_DIR/.env.example" ]] || fail "Missing $MCP_DIR/.env.example"+ log "No .env found — generating one (press Enter to accept defaults)"++ gen_key() { python3 -c "import secrets;print('$1' + secrets.token_hex(24))"; }+ default_api_key="$(gen_key mcp_sk_)"+ default_svc_key="$(gen_key svc_)"++ read -rp "MCP_API_KEY (client → MCP) [default: auto-generate]: " api_key+ api_key="${api_key:-$default_api_key}"++ read -rp "MCP_SERVICE_KEY (MCP → backend, must match backend .env) [default: auto-generate]: " svc_key+ svc_key="${svc_key:-$default_svc_key}"++ read -rp "BACKEND_URL [$DEFAULT_BACKEND_URL]: " backend_url+ backend_url="${backend_url:-$DEFAULT_BACKEND_URL}"++ umask 077+ cat >"$ENV_FILE" <<EOF+MCP_API_KEY=$api_key+MCP_SERVICE_KEY=$svc_key+BACKEND_URL=$backend_url+EOF+ log "Wrote $ENV_FILE (mode 600)"++ if [[ "$svc_key" == "$default_svc_key" ]]; then+ warn "MCP_SERVICE_KEY was auto-generated. Update backend .env with the SAME value:"+ warn " MCP_SERVICE_KEY=$svc_key"+ warn "Then restart the backend so MCP can authenticate."+ fi+fi++# --- venv --------------------------------------------------------------------+VENV="$MCP_DIR/.venv"+if [[ ! -d "$VENV" ]]; then+ log "Creating venv at $VENV"+ python3 -m venv "$VENV"+fi+log "Installing Python deps"+"$VENV/bin/pip" install --quiet --upgrade pip+"$VENV/bin/pip" install --quiet -r "$MCP_DIR/requirements.txt"++chown -R "$SERVICE_USER":"$SERVICE_USER" "$MCP_DIR"+chmod 600 "$ENV_FILE"++# --- systemd unit ------------------------------------------------------------+UNIT="/etc/systemd/system/${SERVICE_NAME}.service"+log "Writing $UNIT"+cat >"$UNIT" <<EOF+[Unit]+Description=Homelable MCP server+After=network-online.target+Wants=network-online.target++[Service]+Type=simple+User=$SERVICE_USER+WorkingDirectory=$MCP_DIR+EnvironmentFile=$ENV_FILE+ExecStart=$VENV/bin/uvicorn app.main:app --host 0.0.0.0 --port $MCP_PORT+Restart=on-failure+RestartSec=5++[Install]+WantedBy=multi-user.target+EOF++systemctl daemon-reload+systemctl enable --now "$SERVICE_NAME"+systemctl restart "$SERVICE_NAME"++# --- healthcheck -------------------------------------------------------------+log "Waiting for MCP to come up on :$MCP_PORT"+ok=0+for _ in 1 2 3 4 5 6 7 8 9 10; do+ if curl -fsS "http://127.0.0.1:${MCP_PORT}/health" >/dev/null 2>&1; then+ ok=1; break+ fi+ sleep 1+done+if [[ "$ok" -ne 1 ]]; then+ warn "MCP did not respond on /health within 10s. Check: journalctl -u $SERVICE_NAME -n 50"+else+ log "MCP server is up."+fi++# --- summary -----------------------------------------------------------------+LXC_IP="$(hostname -I 2>/dev/null | awk '{print $1}')"+API_KEY_VALUE="$(grep -E '^MCP_API_KEY=' "$ENV_FILE" | cut -d= -f2-)"++cat <<EOF++----------------------------------------------------------------+MCP server installed.++ Service: $SERVICE_NAME (systemctl status $SERVICE_NAME)+ Listen: http://${LXC_IP:-<lxc-ip>}:${MCP_PORT}/mcp+ Env file: $ENV_FILE+ Logs: journalctl -u $SERVICE_NAME -f++Claude Code client setup:+ claude mcp add --transport sse homelable http://${LXC_IP:-<lxc-ip>}:${MCP_PORT}/mcp \\+ --header "X-API-Key: $API_KEY_VALUE"+----------------------------------------------------------------+EOF