项目简介

Z-Image Studio 是一个集成了CLI命令行、Web界面和MCP服务器功能的本地图像生成工具，使用高质量的Z-Image-Turbo模型，支持在Windows/Mac/Linux系统上高效运行，特别针对Apple Silicon（MPS）和Nvidia CUDA进行了优化。

主要功能

• 三种使用方式：CLI命令行快速生成、Web界面交互式生成、MCP服务器供AI代理调用
• 多硬件支持：自动检测并优化Apple MPS、Nvidia CUDA，无GPU时回退到CPU
• 智能内存管理：自动启用注意力切片防止内存溢出
• 模型精度选择：支持full（最高质量）、q8（平衡）、q4（快速低内存）
• LoRA支持：Web界面可上传管理LoRA，单次生成最多应用4个LoRA
• 种子控制：支持可重复的图像生成
• 多语言界面：支持英文、日文、简体中文和繁体中文

安装步骤

1. 确保系统安装Python 3.11+和uv包管理器
2. 全局安装命令：'uv tool install git+https://github.com/iconben/z-image-studio.git'

• 安装后即可使用'zimg'命令

服务器配置

该MCP服务器支持两种传输协议：

Stdio传输（推荐本地使用）：

{
  "command": "zimg-mcp",
  "args": []
}

SSE传输（需要运行Web服务器）：

{
  "url": "http://localhost:8000/mcp/sse",
  "transport": "http"
}

配置说明：

• 对于Claude Desktop等客户端，使用stdio配置
• 对于Gemini CLI等客户端，使用SSE配置，URL为Web服务器启动后显示的地址

基本使用方法

• CLI生成：'zimg generate "一张未来城市的图片"'
• 启动Web服务器：'zimg serve'（SSE端点自动挂载在'/mcp/sse'）

可用工具

• 'generate'：根据提示词生成图像
• 'list_models'：列出可用模型
• 'list_history'：查看生成历史