让 AI 助手直接操作视频软件：KwaFlux MCP 上手指南

简要回答

KwaFlux 自带本地 MCP 服务，Cursor、Claude、Codex 等 AI 助手可以直接在你的电脑上调用 KwaFlux：修复打不开的视频、增强画质、清理音频噪声、压缩体积、转换格式。你只管说要什么，处理由 KwaFlux 完成，每个任务都在它自己的窗口里看得见。

• KwaFlux 自带本地 MCP 服务，Cursor、Claude、Codex 这类 AI 助手可以直接调用 KwaFlux 干活，而不是写一段 ffmpeg 命令让你自己去粘贴。
• 接入只要三步：装好 Node.js，从 KwaFlux 设置里复制配置，在 AI 助手里重新加载 MCP。
• KwaFlux 目前上线的 40 个功能里，有 31 个可以在对话里直接发起，包括 16 个 AI 增强工具、文件修复、压缩，以及 64 种格式的转换。
• 主动权在你手里：AI 发起下载默认关闭，一个开关就能切断全部 AI 控制，助手提交的每个任务都会出现在 KwaFlux 里。

接入三步搞定，不用敲命令行。生成的文件放在原文件旁边；没有你的允许，不会从网上下载任何东西。

本文会讲清 KwaFlux MCP 是什么、怎么接入你的 AI 助手、可以让它做什么，以及哪些事仍要在桌面应用里完成。

目录

1. KwaFlux MCP 是什么？
2. 可以让它做什么
3. 第 1 步：安装 Node.js
4. 第 2 步：从 KwaFlux 复制配置
5. 第 3 步：开口让助手干活
6. 需要你点头的时候
7. 让请求一次成功的小窍门
8. 问题排查
9. 哪些事留在桌面应用里
10. 常见问题

KwaFlux MCP 是什么？

KwaFlux MCP 是随 KwaFlux 一起安装的一个小型服务，它让同一台电脑上的 AI 助手可以通过 Model Context Protocol（模型上下文协议），把 KwaFlux 的功能当作工具来调用。

MCP 是 AI 应用连接外部工具的开放协议。AI 助手（也就是“宿主”）在本机启动 KwaFlux 的 MCP 服务，通过标准输入输出和它对话。MCP 服务再把每个请求转给正在运行的 KwaFlux，由 KwaFlux 检查之后，放进和你手动点出来的任务同一个队列。

最后这一点很关键。助手不需要去猜命令行参数，它只填几个有类型的字段，比如文件、模块、输出尺寸，完整的任务由 KwaFlux 按界面导出时的同一套规则生成。具体怎么做到的，见AI 助手能在 KwaFlux 里做什么。

可以让它做什么

助手还可以列出任务、带着实时进度条等待任务完成，并暂停、继续、取消或重试它自己提交的任务。

第 1 步：安装 Node.js

和大多数本地 MCP 服务一样，AI 助手用 Node.js 来启动 KwaFlux 的 MCP 服务。KwaFlux 安装包里带了服务脚本，但不带 Node.js 本身。

1. 在 KwaFlux 里打开 设置，进入 Agent（MCP）。
2. 如果页面提示没有检测到 Node.js 或版本过低，按页面上的链接到 nodejs.org 下载当前的 LTS 版本并安装。
3. 回到这个页面，它会重新检测并显示找到的版本。

补充： KwaFlux 生成的配置里写的是 Node.js 的完整路径。从开始菜单或程序坞启动的 AI 助手，常常因为找不到 PATH 里的 Node 而“服务起不来”，写明完整路径就能避开这个问题。

第 2 步：从 KwaFlux 复制配置

还是在 Agent（MCP） 页面，在 MCP 宿主 里选你的 AI 助手。KwaFlux 可以为六种宿主生成配置：Codex、Claude、OpenClaw、DeepSeek（DSH）、Hermes 和 Cursor。

1. 选择宿主。
2. 复制配置片段；宿主支持的话，也可以直接用安装选项。
3. 把它加进宿主的 MCP 配置。只追加 kwaflux 这一项，不要覆盖整个文件。
4. 在助手里重新加载 MCP，或者新开一个会话。

各家宿主的配置文件放在不同位置，逐个宿主的配置说明里列得很清楚。其他支持本地 stdio MCP 服务的应用，也可以照 MCP 配置页手动接入。

用助手的时候保持 KwaFlux 开着。MCP 服务只是传话的，活是应用干的。

第 3 步：开口让助手干活

先说一句只读的话，确认连接正常：

KwaFlux 开着吗？列一下我最近的任务。

然后试一个真正的任务，记得带上文件的完整路径：

把 D:\Videos\trip.mp4 转成 TikTok 格式，转完告诉我。

助手会调用转换工具，然后等这个任务完成。在 KwaFlux 的任务列表里，这个任务会带一个标记，写明是哪个助手提交的，一眼就能和你自己的任务区分开。完成后，新文件保存在 trip.mp4 旁边，助手会拿到它的文件名。

你的宿主可能还会把 KwaFlux 内置的四个工作流显示成提示词或斜杠命令：修复损坏视频、按平台导出、下载后转换、AI 画质修复。选中之后，它们会带着助手按正确的顺序调用工具。

需要你点头的时候

有些事应该由你决定，而不是由助手决定。KwaFlux 把这些放在应用里处理，只有你本人能点：

• 下载默认关闭。 在 Agent 授权 里，允许 Agent 发起下载 可以保持 关闭，可以设为 每次确认（每次弹出桌面窗口，写明链接、保存目录和格式），也可以设为不再询问、一律放行。弹窗 120 秒没人处理就自动作废。详见AI 不能替你按确认键。
• 一个开关切断全部 AI 控制： 允许 AI Agent 控制 KwaFlux。同一个页面还会列出哪些助手连着，并在 最近的 Agent 操作 里列出它们最近 200 次调用，记录里不含参数。
• 助手只能管自己提交的任务。 你在窗口里发起的任务，它看得到，但不能暂停、取消或重试。

让请求一次成功的小窍门

• 给完整路径。 KwaFlux 只接受本机路径，比如 D:\Videos\clip.mp4 或 /Users/you/Movies/clip.mov，不接受网络盘。
• 说目标，别说参数。 “小到能发邮件”“发 Instagram 用”，助手自己会挑对应的预设。
• 先诊断再修复。 检查一个坏文件很快，之后的修复会用诊断推荐的模式。
• 让它等结果。 加一句“转完告诉我”，助手就会跟着任务走，而不是任务一进队列就说“搞定了”。

技巧： 如果宿主允许你限制服务加载哪些工具，可以设置环境变量 KWAFLUX_MCP_TOOLSETS，只加载你用得到的分组，比如 convert,repair。工具少了，模型上下文里就能腾出更多空间。

问题排查

哪些事留在桌面应用里

有 9 个功能需要你盯着画面操作：画框、点选主体，或者看着预览调。它们是有意留在应用里的，比如人像背景移除、天空替换、物体移除、智能补帧和字幕编辑。你要是让助手做这些，它会被告知把你引导回 KwaFlux，而不是瞎猜你想点哪里。

免费的 1 秒、3 秒、5 秒预览也留在应用里。

结语

装好 Node.js，复制配置，开着应用。之后，修复、增强、压缩、转换这些原本要一步步点的活，一句话就能开始，而且每一个你都看得见、停得下。从一个打不开的文件到能直接发布的成片，完整示范见一套完整的 AI 修复工作流。

KwaFlux 自带本地 MCP 服务，支持 Codex、Claude、Cursor 等 MCP 应用。AI 处理在你自己的 GPU 上运行，媒体文件不会为了处理而上传。可在 Windows 10（64 位，1809 或更新版本）、Windows 11，以及搭载 Apple Silicon 的 macOS 12 或更新版本上运行。导入文件和浏览应用都不需要账号。仅在导出、转换、文件修复和从链接下载文件时需要登录并购买付费方案。

下载 KwaFlux · 查看方案