Fixo MCP Server — 完整整合指南。
逐步技術參考文件,協助將任何相容 MCP 的 AI 代理程式連接到 EaseUS Fixo。涵蓋驗證、工具結構描述、非同步工作流程、錯誤處理,以及 60+ 種支援的檔案格式。
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_health、query_upload_url、repair、get_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
- 開啟 Cursor → Settings → MCP
- 點擊 Add New MCP Server
- 選擇 URL 類型
- 輸入:
https://repair.easeus.com/fixo-mcp/v1 - 點擊 Add
3.3 ChatGPT
ChatGPT 可透過連接器支援遠端 MCP Server:
- 在 Settings → Connectors → Advanced 啟用開發者模式
- 建立新的連接器並輸入 MCP Server URL:
https://repair.easeus.com/fixo-mcp/v1 - 在瀏覽器中完成 OAuth 授權
- 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) |
| Scopes | repair: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 TTL | 12 小時 |
| Refresh Token TTL | 30 天 |
首次連線流程
- INITIALIZE 呼叫會回傳 HTTP 401,且
WWW-Authenticate標頭會指向受保護資源的中繼資料 - 您的用戶端會發現授權伺服器,並透過 RFC 7591 動態用戶端註冊完成註冊
- 授權頁面會在瀏覽器中開啟 — 請使用您的 EaseUS 帳戶登入並核准請求
- 用戶端會使用 authorization code(PKCE S256)交換 token,並自動重試工具呼叫
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 回傳 NeedPwd 或 PwdErr,請向使用者詢問檔案密碼,然後以相同的 file_name、file_url 加上 password 再次呼叫。
Input: file_name(必填), file_url(必填), password(選填 — 僅用於加密檔案)
Output: task_id, error(成功時為 0), message
Scope: repair:write
get_repair_status
檢查由 repair 建立的修復任務狀態與進度(0–100)。當狀態為 Pending 或 Processing 時,兩次呼叫之間至少等待 3 秒。當狀態為 Completed、Failed、NeedPwd 或 PwdErr 時停止輪詢。回應訊息中會包含建議的下一步動作。
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 秒 - 在
Completed、Failed、NeedPwd或PwdErr時停止輪詢 - 回應中的
message一律包含建議的下一步動作
結果交付
- 二進位檔案不會進入 AI 上下文 — 可節省 tokens
- 當狀態為
Completed時,請登入 repair.easeus.com/history-repair/ 下載修復後的檔案 - 無浮水印,完整保留原始品質
8. 錯誤處理
錯誤會以 MCP 工具錯誤(ToolError)或帶有非 200 code 欄位的結構化結果形式回傳。
| code | 描述 | 解決方式 |
|---|---|---|
| 401 (HTTP) | MCP 端點上沒有 bearer token | 完成 OAuth 授權 — WWW-Authenticate 標頭會指向中繼資料 |
| 3 | file_name 沒有副檔名 | 請傳入包含副檔名的原始檔名 |
| 2006 | OAuth token 已過期 | 重新授權後再試一次 |
| 5002 | 每日免費修復額度已用盡 | 在 repair.easeus.com 升級為 Pro,或使用 Fixo 桌面應用程式 |
| ToolError | 參數無效或上游服務失敗 | 閱讀錯誤訊息、修正參數後重試 |
9. 速率限制
| 限制 | 免費方案 | Pro / EaseUS 帳戶 |
|---|---|---|
| 每日修復次數 | 1 | 無限制 |
| 檔案大小上限 | 100 MB | 100 MB |
| 狀態輪詢 | 每項任務每 3 秒 1 次呼叫 | 每項任務每 3 秒 1 次呼叫 |
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/,然後下載修復後的檔案。"
}