What can you do with this server?

This server acts as an MCP gateway for ComfyUI, enabling image generation, editing, and processing via AI workflows. * Text-to-Image Generation: Generate images from text prompts using built-in workflows: * Sensenova (supports Chinese prompts, aspect ratio, steps, CFG, seed, batch size) * Z-Image Turbo (fast Lumina2-based generation with configurable resolution, sampler, scheduler) * Qwen-Image-2512 + LoRA (high-quality images with negative prompt and LoRA strength controls) * Background Removal: Remove backgrounds from images using the BiRefNet model. * Image Upscaling: Upscale images to 2K resolution using RealESRGAN + Z-Image Turbo. * Reboot ComfyUI: Remotely restart the ComfyUI service and wait for it to recover. * Batch Processing: Repeat tasks a fixed number of times (submit_batch) or over a time duration (batch_by_time). * Local Output Download: Specify an output_dir to download generated images locally, with Markdown image links returned. * Custom Workflow Support: Automatically register any .json workflow files from local directories as MCP tools, and optionally sync workflows directly from a ComfyUI instance on startup.

How do I use mcp-comfyui?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-comfyui generate an image of a serene mountain landscape" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-comfyui

by bookandmusic

Overview Schema Related Servers Score Discussions

Python

Local

comfyui-mcp

License: MIT Python >=3.11

通过 MCP (Model Context Protocol) 协议调用 ComfyUI，加载并执行 workflow：文生图、图编辑、放大、去背景等。适用于 opencode、Claude Code、Cursor 等 MCP 客户端。

快速启动

uvx --from git+https://github.com/bookandmusic/comfyui-mcp.git comfyui-mcp \
    --comfyui.host 127.0.0.1:8188

首次运行自动下载依赖并创建隔离虚拟环境。5 个内置 workflow 开箱即用，无需额外配置。

Related MCP server: comfyui-mcp

工具列表

内置 workflow（`bundled_` 前缀）

工具名	说明
`bundled_sensenova_json`	Sensenova 文生图
`bundled_image_z_image_turbo_json`	Z-Image Turbo 文生图
`bundled_qwen_image_2512_with_lora_json`	Qwen-Image-2512 + LoRA 文生图
`bundled_utility_birefnet_remove_background_json`	BiRefNet 去背景
`bundled_utility_z_image_turbo_2k_upscaler_json`	Z-Image Turbo 2K 放大

附加工具

工具名	说明
`reboot_comfyui`	重启 ComfyUI 服务，等待恢复后返回成功消息

本地 workflow

放入 --comfyui.workflow_directory 的 .json 文件会自动注册为工具，工具名为文件名中的 . 替换为 _，例如 my_workflow.json → my_workflow。

各工具共有参数

参数	类型	说明
`prompt`	string	图像描述（非必填，由具体 workflow 决定）
`seed`	int	随机种子，留空自动生成。多批时自动递增
`batch_by_time`	bool	按时间轮询（分钟），与 `submit_batch` 配合
`submit_batch`	int	重复执行次数，或 `batch_by_time=true` 时的轮询分钟数
`output_dir`	string	可选，本地目录。提供时将结果图片下载到此目录并返回 Markdown 图片链接

配置

comfyui-mcp 的所有配置通过命令行参数传入，不支持配置文件。启动参数如下：

启动参数

参数	默认值	说明
`--comfyui.host`	`$COMFYUI_HOST` 或 `127.0.0.1:8188`	ComfyUI 服务的 host:port
`--comfyui.workflow_directory`	`~/.config/comfyui-mcp/workflows`	本地工作流目录（sync 时也作为下载目标）
`--comfyui.additional_workflow_directories`	`[]`	额外工作流目录列表
`--comfyui.sync_from_comfyui`	`false`	启动时从 ComfyUI 同步所有 `.json` 到本地
`--comfyui.request_timeout`	`30`	HTTP 请求超时（秒）
`--comfyui.max_retries`	`5`	失败重试次数
`--comfyui.queue_check_interval`	`2.0`	队列轮询间隔（秒）
`--comfyui.max_wait_time`	`None`	任务最长等待时间（秒，`None`=无限）
`--comfyui.reboot_timeout`	`300`	`reboot_comfyui` 工具等待恢复时间（秒）

Workflow 来源（按优先级）

1. 内置 workflow

随 wheel 打包，始终加载。工具名带 bundled_ 前缀，不与用户 workflow 冲突。

2. 本地目录

--comfyui.workflow_directory 指定的目录（默认 ~/.config/comfyui-mcp/workflows/）。放入 .json 文件，重启后自动注册。目录不存在时自动创建。

cp my-workflow.json ~/.config/comfyui-mcp/workflows/

需要多个目录时：

--comfyui.additional_workflow_directories '["/path/to/dir1", "/path/to/dir2"]'

3. 从 ComfyUI 同步（可选）

--comfyui.sync_from_comfyui true 启动后，MCP 调用 ComfyUI 的 /api/v2/userdata 列出所有 .json 文件并下载到本地 workflow_directory。适用于集中式 workflow 库 + 多 MCP 实例、跨机部署等场景。

uvx --from git+https://github.com/bookandmusic/comfyui-mcp.git comfyui-mcp \
    --comfyui.host 127.0.0.1:8188 \
    --comfyui.sync_from_comfyui true

注意：同步范围包括 userdata 下所有 .json（含非 workflow 的配置如 styles.json），缺少 nodes 字段的文件会报加载错误但不中断启动。

客户端配置

opencode

{
  "mcp": {
    "comfyui": {
      "type": "local",
      "command": [
        "uvx",
        "--from", "git+https://github.com/bookandmusic/comfyui-mcp.git",
        "comfyui-mcp",
        "--comfyui.host", "127.0.0.1:8188"
      ],
      "enabled": true,
      "timeout": 600000
    }
  }
}

Claude Code

添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "comfyui": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/bookandmusic/comfyui-mcp.git",
        "comfyui-mcp",
        "--comfyui.host", "127.0.0.1:8188"
      ]
    }
  }
}

也可放在项目级 .claude/settings.local.json 中。

本地开发

git clone https://github.com/bookandmusic/comfyui-mcp.git
cd comfyui-mcp
uv sync
uv run python -m comfyui_mcp.server --comfyui.host 127.0.0.1:8188

或安装为本地命令：

uv tool install .
comfyui-mcp --comfyui.host 127.0.0.1:8188

License

MIT — 详见 LICENSE。

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bookandmusic/mcp-comfyui'

If you have feedback or need assistance with the MCP directory API, please join our Discord server