image-generation-mcp

Image Generation MCP Server

MCP server for AI image generation via OpenAI, Stable Diffusion (SD WebUI), or placeholders.

communityservice

Package Details

image-generation-mcp

1.3.0•https://pypi.org/project/image-generation-mcp

Transportstdio

Runtimeuvx

Environment Variables

IMAGE_GENERATION_MCP_READ_ONLY(bool)

Default:true

When true, write-tagged tools (generate_image) are hidden. Set to false to enable image generation.

IMAGE_GENERATION_MCP_SCRATCH_DIR(file)

Directory for saved generated images. Created automatically on first use.

IMAGE_GENERATION_MCP_DEFAULT_PROVIDER

Default:auto

Default provider selection: auto (keyword-based), openai, sd_webui, or placeholder. Deprecated alias 'a1111' is also accepted.

IMAGE_GENERATION_MCP_OPENAI_API_KEY

Secret

OpenAI API key. Enables the OpenAI provider (gpt-image-1, dall-e-3) when set.

IMAGE_GENERATION_MCP_SD_WEBUI_HOST

SD WebUI base URL (e.g. http://localhost:7860). Enables the SD WebUI provider when set.

IMAGE_GENERATION_MCP_SD_WEBUI_MODEL

SD WebUI checkpoint name for model-aware preset detection (SD 1.5 vs SDXL vs Lightning vs Flux).

IMAGE_GENERATION_MCP_A1111_HOST

Deprecated — use SD_WEBUI_HOST instead. Accepted as fallback.

IMAGE_GENERATION_MCP_A1111_MODEL

Deprecated — use SD_WEBUI_MODEL instead. Accepted as fallback.

FASTMCP_LOG_LEVEL

Default:INFO

Log level for FastMCP internals; app loggers default to INFO, -v overrides both to DEBUG.

IMAGE_GENERATION_MCP_SERVER_NAME

Default:image-generation-mcp

Server name shown to MCP clients in the initialization response.

IMAGE_GENERATION_MCP_INSTRUCTIONS

System-level instructions injected into LLM context.

IMAGE_GENERATION_MCP_BEARER_TOKEN

Secret

Static bearer token for HTTP authentication.

IMAGE_GENERATION_MCP_AUTH_MODE

OIDC auth mode: 'remote' (JWKS validation) or 'oidc-proxy' (OAuth proxy). Auto-detected if not set.

IMAGE_GENERATION_MCP_BASE_URL

Public base URL for OIDC redirects (e.g. https://mcp.example.com). Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CONFIG_URL

OIDC discovery endpoint URL. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CLIENT_ID

OIDC client ID. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CLIENT_SECRET

Secret

OIDC client secret. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_JWT_SIGNING_KEY

Secret

Signing key for OIDC session JWTs (critical on Linux/Docker).

IMAGE_GENERATION_MCP_OIDC_AUDIENCE

Expected JWT audience claim. Leave unset if your provider does not set one.

IMAGE_GENERATION_MCP_OIDC_REQUIRED_SCOPES

Comma-separated required OIDC scopes (default: openid for oidc-proxy mode, none for remote mode).

IMAGE_GENERATION_MCP_OIDC_VERIFY_ACCESS_TOKEN(bool)

Default:false

Verify access token JWT instead of id_token.

ghcr.io/pvliesdonk/image-generation-mcp:v1.3.0

https://github.com/pvliesdonk/image-generation-mcp/pkgs/container/image-generation-mcp

TransportStreamable HTTP

Package Arguments

Named

--port

Port for the HTTP transport

Environment Variables

IMAGE_GENERATION_MCP_READ_ONLY(bool)

Default:true

When true, write-tagged tools (generate_image) are hidden. Set to false to enable image generation.

IMAGE_GENERATION_MCP_SCRATCH_DIR(file)

Default:/data/scratch

Directory for saved generated images inside the container.

IMAGE_GENERATION_MCP_DEFAULT_PROVIDER

Default:auto

Default provider selection: auto (keyword-based), openai, sd_webui, or placeholder. Deprecated alias 'a1111' is also accepted.

IMAGE_GENERATION_MCP_OPENAI_API_KEY

Secret

OpenAI API key. Enables the OpenAI provider (gpt-image-1, dall-e-3) when set.

IMAGE_GENERATION_MCP_SD_WEBUI_HOST

SD WebUI base URL (e.g. http://localhost:7860). Enables the SD WebUI provider when set.

IMAGE_GENERATION_MCP_SD_WEBUI_MODEL

SD WebUI checkpoint name for model-aware preset detection (SD 1.5 vs SDXL vs Lightning vs Flux).

IMAGE_GENERATION_MCP_A1111_HOST

Deprecated — use SD_WEBUI_HOST instead. Accepted as fallback.

IMAGE_GENERATION_MCP_A1111_MODEL

Deprecated — use SD_WEBUI_MODEL instead. Accepted as fallback.

FASTMCP_LOG_LEVEL

Default:INFO

Log level for FastMCP internals; app loggers default to INFO, -v overrides both to DEBUG.

IMAGE_GENERATION_MCP_SERVER_NAME

Default:image-generation-mcp

Server name shown to MCP clients in the initialization response.

IMAGE_GENERATION_MCP_INSTRUCTIONS

System-level instructions injected into LLM context.

IMAGE_GENERATION_MCP_HTTP_PATH

Default:/mcp

HTTP endpoint mount path for streamable-HTTP transport.

PUID(num)

Default:1000

Run as this UID (Docker entrypoint).

PGID(num)

Default:1000

Run as this GID (Docker entrypoint).

IMAGE_GENERATION_MCP_BEARER_TOKEN

Secret

Static bearer token for HTTP authentication.

IMAGE_GENERATION_MCP_AUTH_MODE

OIDC auth mode: 'remote' (JWKS validation) or 'oidc-proxy' (OAuth proxy). Auto-detected if not set.

IMAGE_GENERATION_MCP_BASE_URL

Public base URL for OIDC redirects (e.g. https://mcp.example.com). Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CONFIG_URL

OIDC discovery endpoint URL. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CLIENT_ID

OIDC client ID. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_CLIENT_SECRET

Secret

OIDC client secret. Required for OIDC.

IMAGE_GENERATION_MCP_OIDC_JWT_SIGNING_KEY

Secret

Signing key for OIDC session JWTs (critical on Linux/Docker).

IMAGE_GENERATION_MCP_OIDC_AUDIENCE

Expected JWT audience claim. Leave unset if your provider does not set one.

IMAGE_GENERATION_MCP_OIDC_REQUIRED_SCOPES

Comma-separated required OIDC scopes (default: openid for oidc-proxy mode, none for remote mode).

IMAGE_GENERATION_MCP_OIDC_VERIFY_ACCESS_TOKEN(bool)

Default:false

Verify access token JWT instead of id_token.