在 Cursor 里驱动 KwaFlux：MCP 配置、第一批指令与排障

要点速览

• Cursor 的 Agent 可以通过 KwaFlux 自带的本地 MCP 服务来操作 KwaFlux。配置只要在 KwaFlux 里点一个按钮，或者往 mcp.json 里加一项。
• 保持 KwaFlux 开着，并装好 Node.js。这个服务是你电脑上的本地程序，所以 Cursor 的云端 Agent 连不到它。
• Cursor 默认会在运行 MCP 工具前征求你的同意。先批准几个只读工具，确认连接正常。
• 配置失败多半出在三件事上：JSON 里的 Windows 路径没转义、改错了 mcp.json、改完没重新加载。

Cursor 的 Agent 可以通过随 KwaFlux 一起安装的本地 MCP 服务，在你的电脑上操作 KwaFlux。在 KwaFlux 里打开 设置 › Agent（MCP），选 Cursor，点 在 Cursor 中安装；或者把一项配置粘进 Cursor 的 mcp.json。接着就可以让 Agent 诊断、修复、转换或增强视频。

整个配置大约五分钟。服务由 Cursor 启动，处理由 KwaFlux 完成。

本文会讲把 KwaFlux 接入 Cursor 的两种方法、怎么确认连通、先试哪些指令，以及常见问题怎么解决。

目录

1. Cursor 拿 MCP 服务做什么？
2. 开始之前
3. 方法一：在 KwaFlux 里点一个按钮安装
4. 方法二：自己编辑 mcp.json
5. 确认已经连上
6. 第一批指令
7. 审批与自动运行
8. 问题排查
9. 常见问题

Cursor 拿 MCP 服务做什么？

MCP 服务给 Cursor 的 Agent 加上额外的工具。对本地（stdio）服务来说，Cursor 加载时会在你的电脑上启动这个程序，Agent 在请求需要时调用它的工具。

KwaFlux 的服务是随应用安装的一个 Node.js 脚本。它的工具可以查看应用状态、把转换、修复、增强这类任务排进队列，并等待任务完成。Agent 是什么、这个循环怎么运转，见什么是 AI Agent。

开始之前

补充： 在 Mac 上，KwaFlux 生成的配置指向应用包里的一个辅助程序（<KwaFlux.app>/Contents/Helpers/kwaflux-mcp-run），而不是脚本路径。请从应用里复制，这样填进去的是真实位置。

方法一：在 KwaFlux 里点一个按钮安装

1. 在 KwaFlux 里打开 设置，进入 Agent（MCP）。
2. 在 MCP 宿主 里选 Cursor。
3. 点 在 Cursor 中安装。KwaFlux 会复制配置，并用安装链接唤起 Cursor。
4. 在 Cursor 里确认安装。
5. 照 KwaFlux 的提示做：“装完后在 Cursor 里 Reload MCP。”

点下去之后，KwaFlux 会先复制配置，再提示“已复制配置并唤起 Cursor；若未打开请手动粘贴”。如果 Cursor 没被唤起，改用方法二即可，配置已经在剪贴板里了。

这个按钮打开的链接长这样，末尾是编码后的配置：

cursor://anysphere.cursor-deeplink/mcp/install?name=kwaflux&config=eyJjb21tYW5kIjoiQzpcXFByb2dyYW0gRmlsZXNcXG5vZGVqc1xcbm9kZS5leGUiLCJhcmdzIjpbIkM6XFxQcm9ncmFtIEZpbGVzXFxLd2FGbHV4XFxUb29sc1xca3dhZmx1eC1tY3BcXGt3YWZsdXhfbWNwLm1qcyJdfQ

这是 Windows 默认安装位置对应的链接。如果你把 KwaFlux 装在别处，链接会不一样。

方法二：自己编辑 mcp.json

Cursor 从两个文件读取 MCP 服务：

KwaFlux 是桌面应用，不属于某个项目，所以用全局文件。

1. 在 KwaFlux 的 MCP 宿主 里选 Cursor，点 复制配置。
2. 打开 ~/.cursor/mcp.json，没有就新建。
3. 如果是新文件，整段粘进去；如果里面已有别的服务，只把 kwaflux 这一项加进现有的 mcpServers 里。

Windows 默认安装位置对应的配置是：

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

4. 保存后重启 Cursor，或者在 Customize 里把这个服务关掉再打开。

技巧： 双反斜杠要保留。在 JSON 里，单个 \ 表示转义的开始，写成 C:\Program Files 整个文件就无效了，Cursor 会把文件里所有服务一起丢掉，不只是 KwaFlux。

确认已经连上

1. 打开 Cursor 侧栏的 Customize，找到 kwaflux。它应该处于开启状态，并列出工具。
2. 在 Agent 对话里问：

KwaFlux 开着吗？用 KwaFlux 的工具查一下。

Agent 会调用 kwaflux_get_app_status。KwaFlux 开着时，回答里会说明你是否已登录；关着时，工具返回一个以 app_not_running 开头的错误，打开 KwaFlux 再问一次就行。

3. 再让它列出任务列表。哪怕是空列表也没关系，说明整条链路通了。

第一批指令

给出完整的本机路径，并说清楚结果要拿去做什么：

每个任务都会出现在 KwaFlux 的任务列表里，你可以在那里看进度、暂停或取消。转换的细节见转换器。

智能补帧，以及抠像和替换类工具，仍要在应用里做，助手会被告知把你引导过去。AI 发起下载默认关闭，要在 Agent 授权 里把 允许 Agent 发起下载 设为 每次确认。之后每次下载 KwaFlux 都会弹窗问你，助手也会在对话里请你确认有权下载那些内容。

审批与自动运行

Cursor 的文档写明，它“默认会在使用 MCP 工具前请求批准”，而且 MCP 工具和终端命令遵循同一套运行模式。用在 KwaFlux 上，这个默认值很合理：

• 只读工具，比如应用状态、任务列表、任务详情、导出格式列表，可以放心加进允许列表。
• 排任务的工具会在源文件旁边写出新文件。在你对自己的指令有把握之前，这类工具继续亲手批准。

问题排查

不只出现在 Cursor 上的问题，见 KwaFlux MCP 排障指南。

结语

点 在 Cursor 中安装，或者往 ~/.cursor/mcp.json 里加一项。然后重新加载，保持 KwaFlux 开着，第一个正式任务之前先让 Agent 查一下应用状态。之后，转换、修复、增强都可以从 Cursor 的对话里发起，并出现在 KwaFlux 的任务列表里。

在 Cursor 里驱动 KwaFlux

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

下载 KwaFlux · 查看方案