Agent Tools 与 MCP

Comfy CLI

从终端驱动 Comfy：本地 ComfyUI、合作伙伴生成调用以及 Comfy Cloud 上的完整工作流。与 MCP 互补，适用于脚本、CI 和自动化。

官方中文源 / agent-tools/cli.mdx / 固定提交 e433279d

comfy-cli 是 Comfy 的命令行工具。与 MCP 服务器 一起，它为代理和开发者提供了另一种从 UI 外部驱动 Comfy 的方式。

用于终端或脚本访问：批处理任务、CI 流水线、工作流自动化，以及通过捆绑的 CLI 技能与编码代理配对。

如何与 MCP 配合使用

Comfy Cloud MCP Comfy CLI
接口 与 MCP 客户端（Claude Code、Claude Desktop 等）对话 终端命令和脚本
适用场景 聊天中的交互式代理工作流 自动化、批量运行、CI、Shell 管道
认证 MCP 客户端中的 OAuth，或 API 密钥（无头模式） comfy cloud login（OAuth）或 API 密钥（CI）
输出 返回至聊天会话 保存到磁盘（--download）或 JSON（--json）

有关 MCP 设置、安装、工具列表和认证方法，请参阅 Comfy Cloud MCP。

CLI 能做什么

  1. 本地 ComfyUI — 安装、启动、更新和管理自定义节点
  2. 合作伙伴生成 — comfy generate 用于一次性图像/视频/音频/3D 合作伙伴 API 调用
  3. 云端工作流 — comfy run、模板、插槽编辑和 Comfy Cloud 上的任务监控

安装和设置

bash
pip install comfy-cli
bash
brew tap Comfy-Org/comfy-cli
brew install comfy-org/comfy-cli/comfy-cli

获取 shell 自动补全提示：

bash
comfy --install-completion
bash
comfy setup

在 CI 或脚本中传递 -y 以进行非交互式安装。有关完整的 comfy setup 标志表，请参阅 Comfy CLI 入门。

登录 Comfy Cloud：

bash
comfy cloud login
comfy cloud whoami

comfy generate 的前提条件

首次生成

bash
comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png

CLI 会上传本地文件，提交任务，轮询完成状态，并保存结果。

可用模型

comfy generate 涵盖图像和视频合作伙伴模型。发现你的 CLI 版本中可用的模型：

bash
comfy generate list                            # 全部模型
comfy generate list --category text-to-video   # 筛选方式：文生视频
comfy generate list --partner kling            # 筛选方式：合作伙伴
comfy generate schema flux-kontext             # 某个模型的参数

常用别名包括：

类别 示例
图像 flux-pro, flux-ultra, flux-kontext, nano-banana, grok, grok-edit, ideogram-edit, dalle, recraft, stability
视频 seedance, kling, luma, runway, pika, vidu, hailuo, moonvalley, grok-video

运行 comfy generate list 获取你环境中的完整列表。

使用示例

文生图

bash
comfy generate nano-banana \
    --prompt "a watercolor of a sleeping fox" \
    --download fox.png

图像编辑（参考图像）

传递本地文件路径。CLI 通过 Comfy 的存储端点上传或按需进行 base64 编码：

bash
comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

comfy generate flux-kontext \
    --prompt "add a top hat and a monocle" \
    --input_image ./photo.jpg \
    --download out.png

comfy generate ideogram-edit \
    --image cat.png --mask mask.png \
    --prompt "add sunglasses" \
    --rendering_speed TURBO \
    --download edited.png

要上传一次并在多次调用中重复使用：

bash
comfy generate upload ./photo.jpg     # 打印一个已签名的 URL

文生视频

视频任务是异步的。CLI 默认会阻塞并轮询：

bash
comfy generate seedance \
    --prompt "a hummingbird hovering over a flower" \
    --resolution 1080p --duration 5 \
    --download hummingbird.mp4

comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4

使用 --async 立即返回，稍后恢复：

bash
comfy generate luma --prompt "neon koi swimming through clouds" --aspect_ratio 16:9 --async
# prints a job id; resume with:
comfy generate resume luma <job_id> --download out.mp4

使用 JSON 编写脚本

bash
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'

超越 comfy generate

以上是对代理功能的总结。完整指南深入介绍了每个命令：

  • comfy run、comfy jobs 和 comfy validate 用于完整工作流
  • comfy templates 和 comfy workflow 插槽编辑
  • comfy nodes / comfy models 发现
  • --json 输出包以及用于代理的 comfy --json discover

→ Comfy CLI 入门（完整文档）

代理技能

将捆绑的Comfy代理技能安装到Claude Code、Cursor以及任何支持AGENTS.md的工具中，让你的编码代理可以直接驱动CLI：

bash
comfy skills install
comfy skills list      # comfy, comfy-fragments, comfy-debug, comfy-relay, comfy-director
comfy skills status    # 查看各工具中已安装的技能

相关资源

资源 用途
Comfy CLI 入门 完整安装指南和命令演练
Comfy CLI 参考 命令、标志和模型别名
Comfy Cloud MCP 通过 MCP 连接代理，实现聊天驱动的生成
GitHub 上的 comfy-cli 源码仓库、问题反馈及最新行为

反馈

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明，不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0，来源和修改说明