local-image-mcp
Provides model discovery and download capabilities by checking and pulling image-generation model files from the Hugging Face cache, respecting HF_HUB_CACHE/HF_HOME and skipping already-cached files.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
local-image-mcp
Status: early development (Phase 1 of 7). The core, the model registry, the
fakebackend and the CLI work. The stable-diffusion.cpp backend (Phase 2) and the MCP server (Phase 3) are not ready yet. See PLAN.md.
local-image-mcp connects Claude Code (and other MCP clients) to image generation models
that run on your own GPU. Claude does the reasoning. When a project needs an image, it
calls this server, and the image is generated locally from GGUF models in your
Hugging Face cache.
Development quick start
Requirements: Python 3.12 and uv.
uv sync
uv run local-image models list
uv run local-image generate --model fake --prompt "a red fox in the snow" --seed 42
uv run local-image doctorThe fake model writes a solid-colour PNG without a GPU. Every image gets a JSON file
with the same name. The JSON contains all settings, so you can generate the image again:
uv run local-image regenerate generated-images/<name>.jsonChecks (the same as CI):
uv run ruff check . && uv run ruff format --check . && uv run pyright && uv run pytestRelated MCP server: io.github.pvliesdonk/image-generation-mcp
Models
Model | Capabilities | VRAM (estimate) | License of the weights |
| text2img | ~7 GB | Apache-2.0 |
| text2img, reference, edit | ~6 GB | Apache-2.0 |
The code license (Apache-2.0) does not cover the models. Check the license of each model before you use its output. For example, FLUX.2 klein 9B uses a non-commercial license.
local-image models check shows which model files are in your Hugging Face cache
(HF_HUB_CACHE / HF_HOME are respected). Only local-image models pull <model>
downloads files, and it skips files that are already in the cache.
License
Apache-2.0. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
Generate AI images and videos from any compatible MCP client.
Chat, image, video, and audio models from many vendors behind one remote MCP server and one key.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables seamless integration between MCP-compatible clients (like LM Studio) and Google Gemini API for image generation and multimodal tasks. Provides a hybrid local-cloud workflow combining local LM Studio execution with Gemini's cloud-powered image generation capabilities.13MIT
- AlicenseAqualityCmaintenanceMulti-provider image generation MCP server that enables image generation from Claude Desktop, Claude Code, or any MCP client using OpenAI, Google Gemini, Stable Diffusion, or a placeholder provider.1071 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceA remote MCP server that exposes Gemini image generation/editing as a custom connector for Claude, enabling image creation and editing from any chat interface.-
- FlicenseNot gradedqualityDmaintenanceMCP server for local image generation using FLUX.2 via Hugging Face diffusers, designed to run on a Windows GPU and be called remotely by Claude Cowork over Tailscale.-