Skip to main content
Glama
iconben

Z-Image Studio

by iconben
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoThe host to bind the server to when running in 'serve' mode.0.0.0.0
PORTNoThe port to bind the server to when running in 'serve' mode.8000
ZIMAGE_BASE_URLNoBase URL for generated links. Used to construct absolute URLs for ResourceLinks when using SSE or Streamable HTTP transports.
ZIMAGE_DISABLE_MCPNoSet to '1' to disable all MCP endpoints (default is '0').0
Z_IMAGE_STUDIO_DATA_DIRNoOverride the default data directory location where the database and LoRAs are stored.
HSA_OVERRIDE_GFX_VERSIONNoFor AMD ROCm users on Linux, manual override for gfx version (e.g., '10.3.0' for RDNA2, '11.0.0' for RDNA3) if the GPU is not officially supported.
Z_IMAGE_STUDIO_OUTPUT_DIRNoOverride the default output directory location where generated images are saved.
ZIMAGE_ENABLE_TORCH_COMPILENoForce enable torch.compile optimization (experimental). Set to '1' to enable. By default disabled for Python 3.12+ due to known compatibility issues.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
generateA
Generate an image from a text prompt.

Returns a consistent content array for both stdio and SSE transports:
1. TextContent: Enhanced metadata including generation info and file details
2. ResourceLink: Main image file reference with context-appropriate URI:
   - SSE: Absolute URL built from request context (X-Forwarded-* headers), ZIMAGE_BASE_URL, or relative path
   - Stdio: file:// URI for local access
3. ImageContent: Thumbnail preview (base64 PNG, max 400px)

URI Building Priority (SSE):
1. Context parameter (ctx.request_context.request) - builds absolute URL from request headers
2. ZIMAGE_BASE_URL environment variable - uses configured base URL
3. Relative URL - fallback when no other method available

File metadata (filename, file_path) is in TextContent to avoid duplication in ResourceLink.

For long-running operations (high steps/large images), this function will:
- Send progress notifications at key milestones via ctx.report_progress()
- Handle client disconnections gracefully
list_modelsA

List available image generation models and hardware recommendations.

list_historyC

List recent image generations history.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored across 3 tools

Disambiguation5/5

The three tools have completely distinct purposes: generating images, listing generation history, and listing available models. There is no functional overlap, so an agent can clearly differentiate them.

Naming Consistency5/5

All tool names use lowercase snake_case with a clear verb-first pattern. Although 'generate' is a single verb while the others are 'list_*', the convention is consistent and predictable across the set.

Tool Count4/5

With only 3 tools, the server is on the minimal side but still covers the core functionality of an image generation service. It falls within the acceptable range for a focused tool, though a few more utilities could enhance its scope.

Completeness3/5

The server includes essential operations: generate, view history, and list models. However, it lacks common lifecycle operations such as deleting history entries, viewing a specific generation's details, or updating a generation, which may hinder some workflows.

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources