homelab-mcp-server (main-cfab6f7)

Published 2026-08-16 12:34:18 +00:00 by shcizo

Pull the image from the command line:

docker pull gitea.shcizo.se/shcizo/homelab-mcp-server:main-cfab6f7

Digest

sha256:f643693d4411044026bb4c366632457269c8dc0e4f126debfc7658b9ebbb38e6

For more information on the Container registry, see the documentation.

MCP server for managing Docker containers in a homelab environment

Image Layers

# debian.sh --arch 'amd64' out/ 'trixie' '@1785715200'

ENV PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

RUN /bin/sh -c set -eux; apt-get update; apt-get install -y --no-install-recommends ca-certificates netbase tzdata ; apt-get dist-clean # buildkit

ENV PYTHON_VERSION=3.14.7

ENV PYTHON_SHA256=3b48dac8fb59f62eaa67ac83c1eb12bda1b7a08406dd286e252c11a66be27f81

RUN /bin/sh -c set -eux; savedAptMark="$(apt-mark showmanual)"; apt-get update; apt-get install -y --no-install-recommends dpkg-dev gcc gnupg libbluetooth-dev libbz2-dev libc6-dev libdb-dev libffi-dev libgdbm-dev liblzma-dev libncursesw5-dev libreadline-dev libsqlite3-dev libssl-dev libzstd-dev make tk-dev uuid-dev wget xz-utils zlib1g-dev ; wget -O python.tar.xz "https://www.python.org/ftp/python/${PYTHON_VERSION%%[a-z]*}/Python-$PYTHON_VERSION.tar.xz"; echo "$PYTHON_SHA256 *python.tar.xz" | sha256sum -c -; mkdir -p /usr/src/python; tar --extract --directory /usr/src/python --strip-components=1 --file python.tar.xz; rm python.tar.xz; cd /usr/src/python; gnuArch="$(dpkg-architecture --query DEB_BUILD_GNU_TYPE)"; ./configure --build="$gnuArch" --enable-loadable-sqlite-extensions --enable-optimizations --enable-option-checking=fatal --enable-shared $(test "${gnuArch%%-*}" != 'riscv64' && echo '--with-lto') --with-ensurepip ; nproc="$(nproc)"; EXTRA_CFLAGS="$(dpkg-buildflags --get CFLAGS)"; LDFLAGS="$(dpkg-buildflags --get LDFLAGS)"; LDFLAGS="${LDFLAGS:-} -Wl,--strip-all"; arch="$(dpkg --print-architecture)"; arch="${arch##*-}"; case "$arch" in amd64|arm64) EXTRA_CFLAGS="${EXTRA_CFLAGS:-} -fno-omit-frame-pointer -mno-omit-leaf-frame-pointer"; ;; i386) ;; *) EXTRA_CFLAGS="${EXTRA_CFLAGS:-} -fno-omit-frame-pointer"; ;; esac; make -j "$nproc" "EXTRA_CFLAGS=${EXTRA_CFLAGS:-}" "LDFLAGS=${LDFLAGS:-}" ; rm python; make -j "$nproc" "EXTRA_CFLAGS=${EXTRA_CFLAGS:-}" "LDFLAGS=${LDFLAGS:-} -Wl,-rpath='\$\$ORIGIN/../lib'" python ; make install; cd /; rm -rf /usr/src/python; find /usr/local -depth $ \( -type d -a \( -name test -o -name tests -o -name idle_test $ \) -o $ -type f -a \( -name '*.pyc' -o -name '*.pyo' -o -name 'libpython*.a' $ \) \) -exec rm -rf '{}' + ; ldconfig; apt-mark auto '.*' > /dev/null; apt-mark manual $savedAptMark; find /usr/local -type f -executable -not $ -name '*tkinter*' $ -exec ldd '{}' ';' | awk '/=>/ { so = $(NF-1); if (index(so, "/usr/local/") == 1) { next }; gsub("^/(usr/)?", "", so); printf "*%s\n", so }' | sort -u | xargs -rt dpkg-query --search | awk 'sub(":$", "", $1) { print $1 }' | sort -u | xargs -r apt-mark manual ; apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; apt-get dist-clean; export PYTHONDONTWRITEBYTECODE=1; python3 --version; pip3 --version # buildkit

RUN /bin/sh -c set -eux; for src in idle3 pip3 pydoc3 python3 python3-config; do dst="$(echo "$src" | tr -d 3)"; [ -s "/usr/local/bin/$src" ]; [ ! -e "/usr/local/bin/$dst" ]; ln -svT "$src" "/usr/local/bin/$dst"; done # buildkit

CMD ["python3"]

RUN /bin/sh -c apt-get update && apt-get install -y curl procps && rm -rf /var/lib/apt/lists/* # buildkit

RUN /bin/sh -c curl -LsSf https://astral.sh/uv/install.sh | sh # buildkit

ENV PATH=/root/.local/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

WORKDIR /app

COPY pyproject.toml uv.lock ./ # buildkit

COPY README.md ./ # buildkit

COPY src/ ./src/ # buildkit

RUN /bin/sh -c uv export --frozen --no-dev --no-emit-project --format requirements-txt > /tmp/requirements.txt && uv pip install --system -r /tmp/requirements.txt && uv pip install --system --no-deps -e . && rm /tmp/requirements.txt # buildkit

RUN /bin/sh -c python -c "import docker, unittest.mock as m; m.patch.object(docker, 'from_env', return_value=None).start(); import homelab_mcp.server as s; registry = s.build_registry(); s.build_server(registry); print('import + construction smoke test OK')" # buildkit

RUN /bin/sh -c groupadd -g 999 docker || true && useradd -m -u 1000 -G 999 mcp && chown -R mcp:mcp /app # buildkit

USER mcp

ENV PYTHONUNBUFFERED=1

ENV DOCKER_HOST=unix:///var/run/docker.sock

ENTRYPOINT ["python" "-m" "homelab_mcp.server"]

HEALTHCHECK &{["CMD-SHELL" "pgrep -f \"python -m homelab_mcp.server\" || exit 1"] "30s" "10s" "5s" "0s" '\x03'}

Key	Value
org.opencontainers.image.created	2026-08-16T12:34:15.945Z
org.opencontainers.image.description	MCP server for managing Docker containers in a homelab environment
org.opencontainers.image.licenses	MIT
org.opencontainers.image.revision	cfab6f73e4bba32a77dc97a8defca9ecc726247f
org.opencontainers.image.source	https://gitea.shcizo.se/shcizo/homelab-mcp-server
org.opencontainers.image.title	Homelab MCP Server
org.opencontainers.image.url	https://gitea.shcizo.se/shcizo/homelab-mcp-server
org.opencontainers.image.vendor	shcizo
org.opencontainers.image.version	latest