用 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 個。