在 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. 方法 1：在 KwaFlux 裡按一個按鈕安裝
4. 方法 2：自己編輯 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），而不是指令碼路徑。請從應用程式裡複製，這樣實際位置才會自動填好。

方法 1：在 KwaFlux 裡按一個按鈕安裝

1. 在 KwaFlux 開啟 設定，進入 Agent（MCP）。
2. 在 MCP 宿主 底下選擇 Cursor。
3. 按下 在 Cursor 中安裝。KwaFlux 會複製設定，並用安裝連結開啟 Cursor。
4. 在 Cursor 裡核准安裝。
5. 依照 KwaFlux 的提示：「安裝後請在 Cursor 重新載入 MCP。」

按下之後，KwaFlux 會先複製設定，再顯示「已複製設定並喚起 Cursor；若未開啟請手動貼上」。如果 Cursor 沒有開啟，改用方法 2 就好，設定已經在剪貼簿裡了。

這個按鈕開啟的連結格式如下，設定內容編碼後放在最後面：

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

這是 Windows 預設安裝位置的連結。如果你把 KwaFlux 裝在別的地方，連結可能會不一樣。

方法 2：自己編輯 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 授權 底下把 允許 Agent 發起下載 設為 每次確認。之後每次下載，KwaFlux 都會跳出視窗，AI 助理也會在對話裡請你確認自己有權下載該內容。

核准與自動執行

Cursor 的文件說，它「預設會在使用 MCP 工具前請求核准」，而 MCP 工具和終端機命令遵循同一套 Run Modes（執行模式）。對 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 · 查看方案