blender-mcp Docker & Self-Hosted Deployment

GitHub

Community plugin to control Blender 3D with any LLM of your choice

25,767 stars Python Python 1 file ยท ~4,226 tokens #3d-modeling#ai#blender#blender-addon#claude#generative-ai#llm#mcp
1. Pull Image (DOCKERHUB) docker pull ahujasid/blender-mcp:latest
2. Docker Run (1-Click Launch) docker run -d --name blender-mcp --restart always ahujasid/blender-mcp:latest
3. Podman Run podman run -d --name blender-mcp --restart always ahujasid/blender-mcp:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/ahujasid/blender-mcp:latest
5. ORAS Pull (OCI Artifact) oras pull ahujasid/blender-mcp:latest
Dockerfile
FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim

WORKDIR /app

ENV UV_COMPILE_BYTECODE=1 \
    UV_LINK_MODE=copy

# Install dependencies first so this layer is cached across source changes
COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-install-project --no-dev

COPY README.md ./
COPY src ./src
RUN uv sync --frozen --no-dev

ENV PATH="/app/.venv/bin:$PATH"

# Blender runs on the host, not in the container. host.docker.internal
# resolves to the host on Docker Desktop (macOS/Windows); on Linux pass
# --add-host=host.docker.internal:host-gateway or use --network=host.
ENV BLENDER_HOST=host.docker.internal \
    BLENDER_PORT=9876

ENTRYPOINT ["mcp-for-blender"]