ComfyUI MCP Skill#

AI 视频生成技能，基于 ComfyUI 的 MCP 服务

功能#

• 🎬 视频生成 - 根据提示词生成 AI 视频
• 📖 分镜生成 - 创建视频分镜脚本
• 🎞️ 视频合成 - 合并多个视频片段
• 📥 视频下载 - 下载生成的视频
• 📊 进度查询 - 查看生成任务进度

技术栈#

• Python 3.10+
• FastMCP
• ComfyUI API
• Docker (可选)

安装#

方式 1：从 GitHub 安装#

bash

cd /root/.nanobot/workspace/skills
git clone https://github.com/lemnt-ai/comfyui-mcp-server.git comfyui-mcp-skill
cd comfyui-mcp-skill
pip install -r requirements.txt

方式 2：Docker 部署#

bash

docker-compose up -d

配置#

环境变量#

变量说明默认值COMFYUI_HOSTComfyUI 服务器地址localhostCOMFYUI_PORTComfyUI 端口8188LOG_LEVEL日志级别INFO

配置文件#

编辑 config/config.yaml：

yaml

comfyui:
  host: localhost
  port: 8188
  timeout: 300

server:
  transport: http
  host: 0.0.0.0
  port: 18060
  path: /mcp

使用说明#

启动服务#

bash

# HTTP 模式
python server.py --transport http --host 0.0.0.0 --port 18060

# stdio 模式
python server.py --transport stdio

工具调用示例#

生成视频

python

generate_video(
    prompt="一个机器人在跳舞",
    duration=5,
    width=512,
    height=512,
    fps=12
)

查询进度

python

check_progress(prompt_id="xxx-xxx-xxx")

下载视频

python

download_video(prompt_id="xxx-xxx-xxx")

集成到 nanobot#

在 nanobot 配置中添加：

json

{
  "mcpServers": {
    "comfyui": {
      "command": "python",
      "args": ["/root/.nanobot/workspace/skills/comfyui-mcp-skill/server.py"],
      "cwd": "/root/.nanobot/workspace/skills/comfyui-mcp-skill",
      "env": {
        "COMFYUI_HOST": "localhost",
        "COMFYUI_PORT": "8188"
      }
    }
  }
}

依赖服务#

ComfyUI 安装#

bash

# 克隆 ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

# 安装依赖
pip install -r requirements.txt

# 启动
python main.py --listen 0.0.0.0 --port 8188

必要节点#

• AnimateDiff
• ControlNet
• IPAdapter

工作流文件#

工作流配置文件位于 workflows/ 目录：

文件说明video_workflow.json视频生成工作流storyboard_workflow.json分镜生成工作流compose_workflow.json视频合成工作流

常见问题#

Q: 视频生成失败？#

A: 检查 ComfyUI 服务是否正常运行，端口是否正确。

Q: 生成速度慢？#

A: 视频生成依赖 GPU，确保有可用的 GPU 资源。

Q: 如何自定义工作流？#

A: 编辑 workflows/ 目录下的 JSON 文件。

相关链接#

• 原项目： https://github.com/lemnt-ai/comfyui-mcp-server
• ComfyUI: https://github.com/comfyanonymous/ComfyUI
• FastMCP: https://github.com/jlowin/fastmcp

版本历史#

• v1.0.0 - 初始版本
  • 视频生成
  • 分镜生成
  • 视频合成
  • 进度查询

---

创建时间：2026-03-17 版本：v1.0.0