Fixo MCP Server — 完整整合指南。

逐步技術參考文件,協助將任何相容 MCP 的 AI 代理程式連接到 EaseUS Fixo。涵蓋驗證、工具結構描述、非同步工作流程、錯誤處理,以及 60+ 種支援的檔案格式。

版本:
更新日期:
端點:https://repair.easeus.com/fixo-mcp/v1

1. 概覽

EaseUS Fixo MCP Server 可讓任何相容 MCP 的 AI 代理程式(Claude、Cursor、ChatGPT、Gemini、Windsurf、Trae、GitHub Copilot 等 50 多種)透過標準化的 Model Context Protocol 介面修復損壞的影片、照片、文件、壓縮檔與音訊檔案。

憑藉 EaseUS 20 年資料修復經驗(已修復 1.2 億+ 檔案、使用者評分 4.8/5),Fixo MCP 提供 4 種專用工具,遵循 MCP 最佳實踐:型別化 JSON Schema、非同步任務支援,以及結構化結果交付。

項目
MCP 端點https://repair.easeus.com/fixo-mcp/v1
傳輸方式Streamable HTTP (JSON-RPC)
工具4 個(check_file_healthquery_upload_urlrepairget_repair_status
類別影片、照片、文件與壓縮檔、音訊
格式100+
檔案大小上限每個檔案 100 MB
驗證OAuth 2.1 — Authorization Code + PKCE,RFC 7591 動態用戶端註冊
結果交付網頁結果頁 URL(預覽 + 下載)
資料保留修復後 14 天自動刪除

2. 快速開始 — 一鍵連線

最簡單的連線方式,是使用來自 MCP 首頁 的一鍵提示詞。無需手動編輯 JSON。

步驟 1:複製提示詞

前往 MCP 首頁 並點擊 複製提示詞。提示詞內容如下:

新增 MCP Server:https://repair.easeus.com/fixo-mcp/v1,OAuth 2.1 Authorization Code + PKCE (S256),無需 API 金鑰。
然後使用 fixo MCP 工具修復 {file path}。

步驟 2:貼到您的 AI 代理程式

開啟您的 AI 助理(Claude、Cursor、ChatGPT 等),並將提示詞貼到新的對話中。

步驟 3:AI 自動完成設定

AI 會讀取這份指南文件,並使用正確的端點 URL 自動設定 Fixo MCP Server 連線。

步驟 4:開始修復檔案

請您的 AI 修復損壞的檔案。它會使用 Fixo 的 4 個 MCP 工具來檢查健康狀態、上傳、啟動修復、監控進度,並回傳結果頁 URL。

3. 手動設定

如果您偏好手動設定,請使用此端點設定您的 MCP 用戶端:https://repair.easeus.com/fixo-mcp/v1

3.1 Claude Desktop

編輯 ~/.claude.json(macOS/Linux)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "fixo": {
      "type": "http",
      "url": "https://repair.easeus.com/fixo-mcp/v1"
    }
  }
}

重新啟動 Claude Desktop。INITIALIZE 呼叫將觸發 OAuth 授權流程。

3.2 Cursor

  1. 開啟 Cursor → Settings → MCP
  2. 點擊 Add New MCP Server
  3. 選擇 URL 類型
  4. 輸入:https://repair.easeus.com/fixo-mcp/v1
  5. 點擊 Add

3.3 ChatGPT

ChatGPT 可透過連接器支援遠端 MCP Server:

  1. Settings → Connectors → Advanced 啟用開發者模式
  2. 建立新的連接器並輸入 MCP Server URL:https://repair.easeus.com/fixo-mcp/v1
  3. 在瀏覽器中完成 OAuth 授權
  4. Fixo 工具現在即可在您的對話中使用

3.4 其他 MCP 用戶端

任何支援 Streamable HTTP 的 MCP 相容用戶端都可以連線,例如 Windsurf、Trae、GitHub Copilot、Continue.dev、Cline、Roo Code 等。它們都使用同一個端點:https://repair.easeus.com/fixo-mcp/v1

4. 驗證與授權

Fixo MCP 使用 OAuth 2.1(含 PKCE S256 的 Authorization Code 流程)來提供安全、無密碼的授權。無需 API 金鑰 — 用戶端會透過 RFC 7591 動態用戶端註冊即時完成註冊。

參數
流程OAuth 2.1 Authorization Code + PKCE (S256)
Scopesrepair:read(健康檢查、狀態)· repair:write(上傳、修復)
用戶端註冊RFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register
伺服器中繼資料RFC 8414 — /.well-known/oauth-authorization-server
資源中繼資料RFC 9728 — /.well-known/oauth-protected-resource
未授權回應帶有 WWW-Authenticate 標頭的 HTTP 401
Access Token TTL12 小時
Refresh Token TTL30 天

首次連線流程

  1. INITIALIZE 呼叫會回傳 HTTP 401,且 WWW-Authenticate 標頭會指向受保護資源的中繼資料
  2. 您的用戶端會發現授權伺服器,並透過 RFC 7591 動態用戶端註冊完成註冊
  3. 授權頁面會在瀏覽器中開啟 — 請使用您的 EaseUS 帳戶登入並核准請求
  4. 用戶端會使用 authorization code(PKCE S256)交換 token,並自動重試工具呼叫
注意:授權需要免費的 EaseUS 帳戶。您可以在驗證流程中註冊。

5. 工具目錄 — 4 個 MCP 工具

所有工具都遵循 MCP 的 tools/call JSON-RPC 方法,並使用型別化 JSON Schema 定義輸入與輸出。

check_file_health

檢查檔案是否健康且適合修復。這是任何修復前建議的第一步 — 應先向使用者提出建議,並僅在取得使用者同意後執行。本機預檢:拒絕 0 位元組檔案、拒絕所有位元組值都相同的檔案,並驗證檔頭/檔尾位元組是否與副檔名相符。

Input: file_name(必填,含副檔名), file_url(必填 — 來自 query_upload_url 的 download_url)

Output: health_status(Intact | Unknown | Damaged), message

Scope: repair:read

query_upload_url

取得用於上傳本機檔案的 S3 上傳 URL 與表單欄位(最大 100 MB)。請將 fields 中的每個鍵值對加上檔案本身,一起以 multipart/form-data POST 到 upload_url(建議使用 curl,並為每個 fields 項目使用一個 -F 選項)。上傳成功後,將 download_url 作為 file_url 傳給其他工具。

Input: file_name(必填,含副檔名)

Output: upload_url, download_url, fields, message(上傳說明)

Scope: repair:write

repair

為已上傳的檔案建立並啟動修復任務。如果 get_repair_status 回傳 NeedPwdPwdErr,請向使用者詢問檔案密碼,然後以相同的 file_namefile_url 加上 password 再次呼叫。

Input: file_name(必填), file_url(必填), password(選填 — 僅用於加密檔案)

Output: task_id, error(成功時為 0), message

Scope: repair:write

get_repair_status

檢查由 repair 建立的修復任務狀態與進度(0–100)。當狀態為 PendingProcessing 時,兩次呼叫之間至少等待 3 秒。當狀態為 CompletedFailedNeedPwdPwdErr 時停止輪詢。回應訊息中會包含建議的下一步動作。

Input: task_id(必填 — 由 repair 回傳)

Output: status, progress(0–100), message

Scope: repair:read

輸入/輸出結構描述範例(repair)

// 輸入
{
  "file_name": "birthday.mp4",
  "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4"
}

// 輸出
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "修復任務已成功建立。"
}

6. 支援的檔案格式(100+)

類別格式
影片MP4, MOV, MKV, WEBM, AVI, ASF, WMV, M4V, 3GP, 3G2, FLV, SWF, MPG, RM, RMVB, MPEG, INSV, MTS, M2TS, TS, RSV, DAT, MXF, BRAW, OGV, DIVX, DV, CRM, LRV, LRF, R3D
照片JFIF, JPE, JIF, JPG, JPEG, PNG, GIF, CR2, CR3, CRW, NEF, NRW, TIF, TIFF, DNG, ARW, RAF, GPR, ORF, SR2, X3F, HEIC, BMP, RW2, RAW, AVIF, WEBP, SVG, SRW, ERF, PEF, SRF, MRW, 3FR, JXL
文件與壓縮檔DOC, DOCX, DOCM, DOTM, DOTX, XLS, XLSX, XLSM, XLTM, XLTX, PPT, PPTX, PPTM, POTM, POTX, PDF, ZIP, ZIPX, EXE, XML, RAR, HTML, AI, PSD, PSB, HWP, PAGES, NUMBERS, KEY, CSV, 7Z, RTF, TXT, HWPX, PST, DXF
音訊MP3, AAC, WAV, FLAC, M4A, WMA, AIF, AIFF, OGG, OGA, APE

7. 非同步任務與結果交付

修復會以非同步方式執行。任務生命週期:Pending → Processing → Completed / Failed(加密檔案則可能出現 NeedPwd / PwdErr)。

狀態含義操作
Pending任務已接受,等待 worker 處理輪詢 get_repair_status
Processing修復進行中持續輪詢 — 兩次呼叫之間至少等待 3 秒
Completed修復成功完成依照 message 中的下載說明操作
Failed修復無法完成向使用者呈現失敗訊息
NeedPwd檔案受密碼保護向使用者詢問密碼,並重新呼叫 repair
PwdErr提供的密碼錯誤請求正確密碼並再次呼叫 repair

輪詢最佳實踐

  • 兩次 get_repair_status 呼叫之間至少等待 3 秒
  • CompletedFailedNeedPwdPwdErr 時停止輪詢
  • 回應中的 message 一律包含建議的下一步動作

結果交付

  • 二進位檔案不會進入 AI 上下文 — 可節省 tokens
  • 當狀態為 Completed 時,請登入 repair.easeus.com/history-repair/ 下載修復後的檔案
  • 無浮水印,完整保留原始品質

8. 錯誤處理

錯誤會以 MCP 工具錯誤(ToolError)或帶有非 200 code 欄位的結構化結果形式回傳。

code描述解決方式
401 (HTTP)MCP 端點上沒有 bearer token完成 OAuth 授權 — WWW-Authenticate 標頭會指向中繼資料
3file_name 沒有副檔名請傳入包含副檔名的原始檔名
2006OAuth token 已過期重新授權後再試一次
5002每日免費修復額度已用盡在 repair.easeus.com 升級為 Pro,或使用 Fixo 桌面應用程式
ToolError參數無效或上游服務失敗閱讀錯誤訊息、修正參數後重試

9. 速率限制

限制免費方案Pro / EaseUS 帳戶
每日修復次數1無限制
檔案大小上限100 MB100 MB
狀態輪詢每項任務每 3 秒 1 次呼叫每項任務每 3 秒 1 次呼叫
注意:超過 100 MB 的檔案需使用 EaseUS Fixo 桌面用戶端,其支援最高可達數 GB 的檔案。

10. 安全性與隱私

  • 加密:所有 MCP、上傳與下載流量在傳輸中均使用 TLS
  • OAuth 2.1:Authorization Code + PKCE 可在不向 AI 用戶端暴露密碼的情況下提供安全授權
  • 最小權限:repair:read 涵蓋健康檢查與狀態輪詢;repair:write 僅在上傳與修復時需要
  • 隱私:檔案絕不與第三方分享,也不會用於 AI 訓練
  • 資料保留:檔案將在 14 天後自動刪除
  • 合規:GDPR、CCPA、SOC 2 Type II、ISO 27001

11. 常見問題

什麼是 Fixo MCP Server?

Fixo MCP Server 是 Model Context Protocol 的實作,讓 AI 代理程式可透過 4 個標準化 MCP 工具修復損壞的影片、照片、文件、壓縮檔與音訊檔案。

哪些 AI 用戶端支援 Fixo MCP?

任何支援 Streamable HTTP 的 MCP 相容用戶端皆可使用:Claude Desktop、Claude Code、Cursor、GitHub Copilot、ChatGPT、Google Gemini、Windsurf、Trae、Continue.dev、Cline、Roo Code 等 50 多種用戶端。

Fixo MCP 可以免費使用嗎?

可以。所有使用者每天可享有 1 次免費修復(上限 100 MB)。EaseUS Pro 帳戶持有者每天可無限次修復。超過 100 MB 的檔案需使用桌面用戶端。

我需要安裝任何東西嗎?

不需要。Fixo MCP 是透過 Streamable HTTP 端點存取的雲端服務,您只需要一個支援 MCP 的 AI 用戶端即可。

我要去哪裡找到修復好的檔案?

當任務狀態達到 Completed 後,請前往 repair.easeus.com/history-repair/ 並使用您的帳戶登入,即可預覽並下載修復好的檔案。無浮水印,完整保留原始品質。

修復需要多長時間?

大多數檔案可在 30–60 秒內完成修復。較大或嚴重損壞的檔案可能需要幾分鐘。get_repair_status 工具可提供即時進度(0–100)。

12. 支援與聯絡方式

管道聯絡方式
支援入口easeus.com/support.html
電子郵件[email protected]
MCP 首頁repair.easeus.com/mcp/
線上修復repair.easeus.com
桌面軟體easeus.com/repair-tools

Fixo MCP 已列於 Smithery、Glama、PulseMCP 與 mcp.so 目錄。

附錄:完整範例 — 修復損壞的影片

步驟 1:取得上傳 URL

// 呼叫
{ "name": "query_upload_url", "arguments": { "file_name": "birthday.mp4" } }

// 結果
{
  "code": 200,
  "data": {
    "upload_url": "https://fixo-uploads.s3.amazonaws.com/",
    "download_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4",
    "fields": {
      "key": "upload/birthday.mp4",
      "policy": "eyJleHBpcmF0aW9uIjoi...",
      "x-amz-algorithm": "AWS4-HMAC-SHA256",
      "x-amz-signature": "a1b2c3..."
    },
    "message": "收到上傳 URL 後,在上傳前請先檢查本機檔案是否超過 100 MB..."
  }
}

步驟 2:上傳檔案

請將 fields 中的每個欄位加上檔案本身,一起以 multipart/form-data POST 到 upload_url

curl -F "key=upload/birthday.mp4" \
     -F "policy=eyJleHBpcmF0aW9uIjoi..." \
     -F "x-amz-algorithm=AWS4-HMAC-SHA256" \
     -F "x-amz-signature=a1b2c3..." \
     -F "file=@/path/to/birthday.mp4" \
     https://fixo-uploads.s3.amazonaws.com/

步驟 3:檢查檔案健康狀態(選填,建議)

// 呼叫
{ "name": "check_file_health", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }

// 結果
{
  "code": 200,
  "health_status": "Damaged",
  "message": "檔案已損壞。請使用相同的 file_name 與 file_url 呼叫修復工具進行修復。"
}

步驟 4:啟動修復

// 呼叫
{ "name": "repair", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }

// 結果
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "修復任務已成功建立。"
}

步驟 5:輪詢狀態直到完成

// 輪詢,兩次呼叫之間至少等待 3 秒
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }

// 最終結果
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "status": "Completed",
  "progress": 100,
  "message": "修復已完成。請使用您的帳戶登入 https://repair.easeus.com/history-repair/,然後下載修復後的檔案。"
}
您的影片已成功修復! - 檔案:birthday_repaired.mp4 - 請登入 repair.easeus.com/history-repair/ 預覽並下載 - 無浮水印,完整保留原始品質