用 MCP 让 AI 助手驱动 KwaFlux

开始之前

• 同一台电脑上已安装并打开 KwaFlux 1.0.8 或更新版本。
• 已安装 Node.js 18 或更新版本，并已加入 PATH。安装包只带 MCP 脚本，不带 Node.js 运行时。
• 一个支持 MCP 的助手应用：Codex、Claude Code 或 Claude Desktop、OpenClaw、DeepSeek（DSH）、Hermes 或 Cursor。

接入你的助手

1. 在 KwaFlux 里打开 设置 → Agent（MCP）。
2. 把对应助手的配置片段复制进它的 MCP 配置。只追加 kwaflux 这一项，不要覆盖整个文件。
3. 在助手里重新加载 MCP，使用期间保持 KwaFlux 打开。

助手能做什么

• 读取应用状态与任务列表，跟进某个任务的进度，等待它完成。
• 对视频用 16 个模块提交增强导出：画质修复、AI 调色、视频防抖、AI 慢动作、去隔行、智能裁剪、卡通动漫化、素描生成、固定风格迁移、人脸重打光，以及六个 AI 美颜模块。
• 转换文件格式，检查媒体文件是否损坏，并修复它。
• 查询链接并下载。助手发起下载默认关闭，要你在设置里打开；每次下载都需要你本人在对话里确认。
• 暂停、恢复、取消或重试任务。

登录与方案

• 读取状态、检查文件是否损坏、暂停或取消任务，都不需要登录。
• 与应用内一致：导出（含增强任务）、转换、文件修复和从链接下载文件需要登录并有付费方案。恢复或重试这几类任务也一样。
• 免费的 1 秒、3 秒、5 秒预览仍在桌面应用里，助手不会渲染这些预览。

文件与连接

• 导出、转换和修复的结果写在源文件旁边。下载写到你指定的现有文件夹。
• 只接受本机路径。网络路径在访问任何文件之前就会被拒绝。
• 连接是本机 stdio：没有远程地址、没有 OAuth，也没有 Authenticate 按钮。Windows 上走仅限当前用户的命名管道；Mac 上走只有你的账户能打开的 socket。
• 新任务的提交频率限制在每分钟约 10 个。