使用说明
z图像mcp
本地图像生成 与 Z-Image-Turbo （6B） 上 macOS 苹果芯片版 通过 玻璃直线磨斜边机 本地人。
双重利用模式：
- LM工作室+MCP -请您当地的LLM生成图像
- 界面渐变 -无LLM的直接生成，更少的内存交换
没有ComfyUI，没有云，没有付费API。比扩散器/PyTorch快2倍。
先决条件
| 最低 | 推荐 | |
|---|---|---|
| 苹果电脑 | 苹果硅（M1+） | M3/M4 Pro/Max |
| 备忘录 | 36 GB | 48 GB以上 |
| 磁盘 | 20 GB自由空间 | 30+GB |
| macOS | 14+ | 15+ |
| LM 工作室 | 0.3.18+ | 最新版本 |
安装
快速方法
curl -sSL https://raw.githubusercontent.com/ctheory/z-image-mcp/main/install.sh | bash
手动方法
git clone https://github.com/ctheory/z-image-mcp.git
cd z-image-mcp
chmod +x install.sh
./install.sh
安装程序：
- 检查您的系统（macOS、苹果硅、36 GB+RAM）
- 克隆 z-image涡轮-mlx
- 安装MLX和依赖项
- 将模型转换为量化MLX格式
- 配置
mcp.jsonpour LM工作室 - 在桌面上创建Gradio快捷方式
- Lance未经测试
使用
模式1:LM工作室+MCP
- 打开 LM 工作室 （或在安装后重新启动）
- 检查 程序 那 z图像 以绿点显示
- 使用工具调用加载模板（Qwen 3.5 4B 或 9B)
- 询问： “在16:9生成火星景观”
LM Studio将在运行前显示确认-单击 允许.
注： 对于LM Studio，轻量级临时交换（~5 GB）是正常的 在生成期间，因为LLM和Z-Image共享内存。 交换在生成后消失。
模式2:Gradio接口（无交换）
双击 Z图像 在桌子上。或在终端：
cd ~/z-image-turbo-mlx
source .venv/bin/activate
python app.py
界面将在浏览器中打开 http://127.0.0.1:7860.
分辨率预设
| 预设 | 分辨率 | 时间（~m4） |
|---|---|---|
1:1 |
1024×1024 | ~60s |
16:9 |
1280×720 | ~45秒 |
9:16 |
720×1280 | ~45秒 |
4:3 |
1152×864 | ~50秒 |
3:4 |
864×1152 | ~50秒 |
MCP工具（LM Studio）
| 输出 | 描述 |
|---|---|
generate_image |
从提示文本生成图像 |
get_status |
服务器状态 |
list_generated_images 图像历史 |
提示提示
- 要具体 ：描述主题、姿势、服装、背景、照明
- 关键词质量 :
volumetric lighting,cinematic,4k,studio softbox - 照片现实主义 :
photorealistic,DSLR photo,35mm film - 风格 :
oil painting,watercolor,pixel art,anime - 加速度 ：添加
cache: fast降速约30%（LeMiCa） - 双语的 ：支持英语和中文
内存优化
VRAM GPU增强器
# Mac 36 GB → 32 GB pour le GPU
sudo sysctl iogpu.wired_limit_mb=32768
重新启动时重置。为了使其永久化：
sudo tee /Library/LaunchDaemons/com.gpu.vram.plist > /dev/null << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
<key>Label</key><string>com.gpu.vram</string>
<key>ProgramArguments</key><array>
<string>/usr/sbin/sysctl</string><string>iogpu.wired_limit_mb=32768</string>
</array><key>RunAtLoad</key><true/>
</dict></plist>
EOF
减少与LM Studio的交换
- 使用 Qwen 3.5 4B 而不是几代人中的9b
- 关闭Chrome和重型应用程序
- 对于0交换：使用Gradio模式（不带LM Studio）
建筑
┌─ Mode 1 : LM Studio ─────────────────────────────┐
│ LM Studio (Qwen 3.5) ──MCP stdio──▶ server.py │
│ server.py ──subprocess──▶ generate_mlx.py │
│ → image PNG sauvée │
│ → mémoire MLX libérée │
└───────────────────────────────────────────────────┘
┌─ Mode 2 : Gradio ────────────────────────────────┐
│ Navigateur ──▶ app.py (Gradio UI) │
│ → generate_mlx.py │
│ → image PNG sauvée │
└───────────────────────────────────────────────────┘
卸载
rm -rf ~/z-image-mcp ~/z-image-turbo-mlx ~/models
rm -f ~/Desktop/Z-Image.command
rm -rf ~/.cache/huggingface
# Retirez "z-image" de ~/.lmstudio/mcp.json
信贷
- Z-Image-Turbo 阿里巴巴统一实验室（Apache 2.0）
- z-image涡轮-mlx 菲迪特·内米尼
- 玻璃直线磨斜边机 苹果公司
- LM 工作室
- 主控程序 par人类学
许可证
麻省理工学院
