Local GPU Imagegen MCP server

Local GPU Imagegen

<!-- mcp-name: io.github.ChevalGrand520/local-gpu-imagegen -->

English | 简体中文

An MCP-first control plane with cryptographic model identity, explicit approvals, and durable run evidence for the ComfyUI setup you already use.

Run a supported ComfyUI workflow from Codex without modifying your setup.

uvx local-gpu-imagegen verify
uvx local-gpu-imagegen setup codex --apply

Setup stores a resolved, version-pinned launcher equivalent to uvx --from local-gpu-imagegen==0.9.1 local-gpu-imagegen serve; it does not depend on a console script from the temporary uvx environment. If an older entry reports clientsetupdrift, remove only that client entry and apply setup again. Starting ComfyUI does not repair an MCP launcher failure; backend readiness is checked after the client loads the server.

Ask Codex:

Run this supported ComfyUI API workflow from Codex: <path>.
Use this prompt: <prompt>. Preserve every other workflow setting.

This path requires Python 3.11 or 3.12, Codex, an already-running local ComfyUI instance, an already-installed model, and one ordinary txt2img API workflow using the supported built-in topology. It uses your existing local image backend and model with no silent model downloads or switches. It does not install a backend, download a model, convert UI-format JSON, or execute a workflow that requires unsupported custom nodes. An explicit Windows portable managed-start option is documented below.

The v0.9 supported host scope is Windows 10/11 x64 with NVIDIA. The single py3-none-any wheel describes pure-Python packaging, not a separate Linux edition or a claim of Linux managed-generation support. Ubuntu CI verifies the platform-neutral MCP, packaging, existing-backend, and unsupported-platform contracts; Windows runs the complete portable-bootstrap suite.

ComfyUI generates the pixels. Local GPU Imagegen controls authority, reproducibility, review, and recovery around that generation.

Five-minute Quickstart | Launch playbook | Alternatives

Bring Your Own ComfyUI Workflow

The retained Codex workflow-onboarding session inspected and registered a supported graph, then bound its exact model components; it did not submit a prompt or use the GPU. Historical generated-image records remain available for technical audit, but v0.9 does not use them as promotional visuals or as evidence of image-quality superiority.

This path requires an existing local image backend and model; there are no silent model downloads or switches.

Guided Bootstrap (Windows NVIDIA)

For an existing environment, run bootstrap status and reuse only a verified portable root, checkpoint, and loopback endpoint. For a zero-environment setup, bootstrap plan shows the exact portable archive, checkpoint, byte ceiling, license URLs, SHA-256 hashes, disk/VRAM requirements, and bounded rollback; bootstrap apply requires the displayed explicit confirmation. Downloads are resumable and never silent. The frozen scope is Windows 10/11 x64 with NVIDIA RTX 20-series or newer, 10 GiB VRAM, and 30 GiB free disk. Docker is not required. This model-free bootstrap contract does not prove image generation or production readiness.

setup is read-only without --apply. The apply path delegates to the client's official mcp add command; Local GPU Imagegen does not edit client configuration files directly or download a model.

Trust proof: the retained ordinary-route result came from one installed Codex session. Discovery did not load weights; trust and route identity were explicit; successful rounds were bounded; review used the original-resolution PNG; finalization was bound to the reviewed bytes; and the run state remains recoverable. The evidence proves this one result, not complete 9+3 acceptance, measured performance, or production readiness.

Shortened. The full README is on GitHub.