ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

comfy-ae-video-factory-mcp MCP 服务配置说明:TaoToken 统一 Key 接入与 settings.json 骨架

comfy-ae-video-factory-mcp MCP 服务配置说明:TaoToken 统一 Key 接入与 settings.json 骨架 1. 从一条视频流水线说起为什么需要 comfy-ae-video-factory-mcp如果你正在用 ComfyUI 做图生视频用 FFmpeg 做转码裁切再手动把素材拖进 After Effects 套模板那你大概率经历过这样的循环ComfyUI 里跑完一个 workflow去输出目录翻文件手动记下文件名打开终端敲 ffmpeg 命令再打开 AE 工程替换占位层最后导出。一条视频还能忍十条视频就开始怀疑人生。comfy-ae-video-factory-mcp 就是为这个场景准备的 MCP 服务。它把 ComfyUI 图生图/图生视频、FFmpeg 后处理、After Effects 模板包装、审核占位和多平台发布包生成串成一条可被 MCP 客户端调用的流水线。简单说它是一个跑在本地 stdio 协议上的 MCP Server对外暴露pipeline_create_job、comfy_submit_workflow、ffmpeg_transcode、ae_render_template等工具让 AI 客户端或自动化脚本按顺序调用。它适合谁三类人一是做 AI 短视频批量生产的开发者需要把 ComfyUI 和 AE 串起来二是已经在用 MCP 客户端比如 Claude Code、Cursor 等管理本地工具的工程师三是想把视频后处理标准化、不想每次手敲 ffmpeg 参数的人。这篇就聚焦一件事怎么把这个 MCP 服务配置进 settings.json并用 TaoToken 统一 Key 打通模型调用通道最后验证服务真的能被调起来。2. 前置准备TaoToken 统一 Key 与本地环境在写 settings.json 之前先把两件事准备好模型调用通道和本地依赖。TaoToken 在这里的角色是统一 Key/API 通道。comfy-ae-video-factory-mcp 本身负责视频流水线编排但流水线里如果需要调用大模型比如生成标题、生成 AE 占位文案、做内容审核占位就可以走 TaoToken 的统一入口而不是每个工具各配一套 Key。你可以在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解接入方式API 端点是 https://taotoken.net/api这个不加 UTM。拿 Key 的路径很直接进控制台创建 API Key然后按需选择模型对话或 Coding Plan。如果你只是给 MCP 服务配一个通用通道用 API Keys 页面生成的 Key 就够了。具体入口模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite本地依赖这块comfy-ae-video-factory-mcp 需要 Node.js 环境、一个可访问的 ComfyUI 服务本地或云端、FFmpeg 和 FFprobe。After Effects 是可选的只有走ae_render_template才需要 aerender。先把这些确认好node -v ffmpeg -version ffprobe -version curl -s http://127.0.0.1:8188/system_stats | head -c 200最后一条是探 ComfyUI 是否活着。如果返回 JSON说明 ComfyUI 端点通。如果 ComfyUI 在别的机器或端口把地址记下来下一步要填进环境变量。注意所有输入输出文件都必须落在VIDEO_FACTORY_ROOT目录下这是这个 MCP 服务的安全限制。配置时别把根目录设成/或用户主目录单独建一个 workspace 更稳。3. settings.json 骨架把 MCP 服务接进客户端MCP 客户端的配置文件通常叫 settings.json 或 mcp.json不同客户端路径不一样但结构一致在mcpServers下加一个服务条目。下面是 comfy-ae-video-factory-mcp 的完整骨架你可以直接复制改路径。{ mcpServers: { comfy-ae-video-factory: { command: node, args: [/absolute/path/comfy-ae-video-factory-mcp/dist/index.js], env: { COMFY_LOCAL_URL: http://127.0.0.1:8188, VIDEO_FACTORY_ROOT: /absolute/path/workspace, FFMPEG_BIN: ffmpeg, FFPROBE_BIN: ffprobe, AERENDER_BIN: /Applications/Adobe After Effects 2025/aerender, TAOTOKEN_API_KEY: sk-你的TaoTokenKey, TAOTOKEN_BASE_URL: https://taotoken.net/api } } } }几个字段逐个说清楚。command和args指向编译后的入口文件所以你得先在项目目录跑npm install npm run build确认dist/index.js存在。COMFY_LOCAL_URL是 ComfyUI 地址本地默认 8188 端口。VIDEO_FACTORY_ROOT是工作区根目录所有任务目录、manifest、输出视频都在它下面。FFMPEG_BIN和FFPROBE_BIN如果已经在 PATH 里直接写命令名即可。Windows 下 aerender 路径要转义反斜杠{ AERENDER_BIN: C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\aerender.exe }TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL是给流水线里需要模型调用的环节用的。如果你的 MCP 客户端本身已经通过 TaoToken 接入模型这两个字段可以留空但建议保留方便服务内部独立调用。Key 从 API Keys 页面拿别硬编码进版本库用环境变量注入更安全。配置写完后重启 MCP 客户端。大多数客户端会在启动时读取 settings.json 并拉起 stdio 子进程。如果客户端有 MCP 服务列表应该能看到comfy-ae-video-factory处于 connected 状态。4. 验证请求从创建任务到生成发布包配置对不对跑一遍工具链就知道。comfy-ae-video-factory-mcp 暴露的工具按流水线顺序排列下面是一条最小验证路径。第一步创建生产任务。调用pipeline_create_job它会在VIDEO_FACTORY_ROOT下建任务目录和 manifest。{ tool: pipeline_create_job, arguments: { jobName: demo_short_001, platforms: [douyin, bilibili] } }成功的话VIDEO_FACTORY_ROOT/demo_short_001/下会出现 manifest.json里面记录了任务元信息和后续步骤占位。第二步提交 ComfyUI workflow。调用comfy_submit_workflow把图生视频的 workflow 提交给 ComfyUI。{ tool: comfy_submit_workflow, arguments: { jobName: demo_short_001, workflowPath: /absolute/path/workspace/workflows/i2v_basic.json } }返回里会带一个 prompt_id。第三步用comfy_get_history查结果{ tool: comfy_get_history, arguments: { promptId: 上一步返回的prompt_id } }拿到视频文件后第四步用media_probe检查规格第五步用ffmpeg_transcode统一比例码率帧率{ tool: ffmpeg_transcode, arguments: { jobName: demo_short_001, input: raw_output.mp4, preset: vertical_1080x1920_30fps } }第六步ae_generate_jsx生成 AE 替换脚本第七步ae_render_template调 aerender 输出包装视频。这里建议先用 dryRun 模式确认命令{ tool: ae_render_template, arguments: { jobName: demo_short_001, templatePath: /absolute/path/workspace/ae/template.aep, dryRun: true } }dryRun 返回的是将要执行的 aerender 命令不实际渲染。确认无误后把 dryRun 设为 false。最后两步review_video_package和platform_prepare_package分别做审核占位和生成各平台发布包。整条链路跑通后VIDEO_FACTORY_ROOT/demo_short_001/下应该有 manifest、转码后的视频、AE 渲染输出和平台发布包目录。如果中间某步失败manifest 里会记录失败步骤方便定位。5. 本篇常见错排查配置和调用过程中几个坑出现频率最高。MCP 服务连不上或工具列表为空。先确认dist/index.js路径是绝对路径且文件存在。相对路径在 MCP 客户端里经常解析错。再看 Node 版本太老的 Node 跑不了 ESM 入口。客户端日志里通常有 stdio 子进程的 stderr翻一下能看到具体报错。ComfyUI 提交 workflow 超时。COMFY_LOCAL_URL填错端口或者 ComfyUI 没启动。用curl http://127.0.0.1:8188/system_stats确认。如果 ComfyUI 在容器里注意容器端口映射别填成容器内地址。文件被拒绝提示不在 VIDEO_FACTORY_ROOT 下。这是安全限制不是 bug。所有输入输出路径都要在根目录内。workflow 文件、AE 模板、素材都放进 workspace别引用外部路径。ffmpeg 报参数错误。这个 MCP 服务对 FFmpeg 参数做了白名单化封装不直接暴露任意 shell。所以你不能传任意 ffmpeg 参数只能用预设。看ffmpeg_transcode支持的 preset 列表选最接近的别自己拼参数。aerender 找不到或渲染失败。AERENDER_BIN路径要精确到可执行文件。macOS 下 aerender 在 AE 安装目录里Windows 下在 Support Files 下。先用 dryRun 看命令再手动在终端跑一遍那条命令确认 aerender 本身能工作。TaoToken 调用返回 401。Key 没填对或过期。去 API Keys 页面重新生成确认TAOTOKEN_BASE_URL是https://taotoken.net/api别多加斜杠或路径。如果客户端本身已经配了模型通道服务内部的 Key 可以留空。提示排障时优先看 MCP 客户端的服务日志和任务目录下的 manifest。manifest 记录了每一步的输入输出和状态比盲猜快得多。6. 把通道固定下来长期编码与 Agent 场景的接入选择如果你只是偶尔跑几条视频上面的 settings.json 骨架够用了。但如果你要把这条流水线做成长期运行的 Agent 或批量生产系统模型调用通道的稳定性就变成关键变量。comfy-ae-video-factory-mcp 的流水线里标题生成、文案占位、审核占位这些环节都可能调模型每次手动换 Key 不现实。这种场景下用 TaoToken 的 Coding Plan 把通道固定下来更省心。它适合长期编码和 Agent 类负载Key 和端点配一次MCP 服务、脚本、客户端共用同一个入口。接入文档里有完整的端点和参数说明配置时对照着填TAOTOKEN_BASE_URL和TAOTOKEN_API_KEY就行。回到这个 MCP 服务本身它的价值在于把 ComfyUI、FFmpeg、AE 这三段原本割裂的流程收进一个可被程序调用的接口层。配置一次 settings.json后面就是按工具名顺序调用。真正花时间的不是写配置而是把 AE 模板的占位层命名规范好——{{MAIN_VIDEO}}、{{TITLE}}、{{SUBTITLE}}、{{LOGO}}、{{CTA}}这些占位层在 AE 工程里预先建好ae_generate_jsx生成的替换脚本才能准确命中。这一步做扎实后面批量生产才不会在渲染环节翻车。
返回列表