RECOVER — Decide Safely After a Failed Machine Action

io.github.GSterlingPress由 GitHub 帳號 GSterlingPress 發布v0.1.3更新於 Nov 2, 2026

Choose the safest next action after an API, MCP, or agent failure before retrying.

已驗證Streamable HTTP可網頁執行開發者工具AI 與機器學習

概覽

AI 產生的概覽

遠端決策服務，把失敗的 API、工具或代理動作轉成六種安全後續動作之一，供重試前參考。

可以做什麼
  • 提交失敗脈絡（方法、狀態碼、錯誤、嘗試次數、是否有副作用、是否有冪等鍵），取得單一確定性決策。
  • 回傳六種結果之一：立即重試、等待、修復請求、先驗證、上報升級或中止。
  • 同時提供風險等級、原因說明與建議的下一步。
  • 可作為代理、自動化流程與後端系統中的重試前檢查點。
適用情境
適合在 API、MCP 工具或自動化呼叫失敗之後、自動重試之前使用，尤其是帶副作用的操作、逾時結果不明、5xx 或 429 回應、請求格式錯誤，或重試預算耗盡等盲目重試可能造成重複副作用的情況。
執行需求
需要一個遠端 Streamable HTTP 端點；未宣告任何套件、帳號、API 金鑰或環境變數。助理需能透過網路存取該託管服務。
安裝前請注意
送出的失敗資訊（狀態碼、錯誤文字、嘗試次數、副作用標記）會交給第三方託管服務；README 稱不儲存原始 IP 與請求內容，但仍應把錯誤訊息視為可能敏感。此工具只給建議、不執行操作，重試帶副作用的呼叫前應先核實其建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 RECOVER — Decide Safely After a Failed Machine Action，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.GSterlingPress%2Frecover/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "recover-decide-safely-after-a-failed-mac": {
      "type": "http",
      "url": "https://recover-api-production-bbba.up.railway.app/mcp"
    }
  }
}

README

RECOVER

A failed machine action happened. What should happen next?

RECOVER is a tiny deterministic decision API for AI agents, MCP clients, automations, and ordinary backend systems. It converts failure context into one of six actions:

RETRY_NOW · WAIT · REPAIR_REQUEST · VERIFY_FIRST · ESCALATE · ABORT

Use it immediately after a failed API/tool/action and before an automatic retry—especially for side-effecting operations, ambiguous timeouts, rate limits, malformed requests, exhausted retry budgets, and uncertain execution outcomes.

Live production

Base URL: https://recover-api-production-bbba.up.railway.app

MCP Streamable HTTP endpoint: https://recover-api-production-bbba.up.railway.app/mcp

Activity dashboard: https://recover-api-production-bbba.up.railway.app/activity

Safe demo: https://recover-api-production-bbba.up.railway.app/demo

REST

POST https://recover-api-production-bbba.up.railway.app/v1/recover

json
{  "method":"POST",  "status":503,  "error":"upstream timeout",  "attempt":1,  "sideEffect":true,  "idempotencyKey":false}

Example response:

json
{  "decision":"VERIFY_FIRST",  "retry":false,  "risk":"high",  "reason":"A side-effecting non-idempotent action may have completed before the failure became visible.",  "next":"Verify external state or obtain an idempotency key before retrying."}

MCP

Tool: recover_decide

Point an MCP client at:

https://recover-api-production-bbba.up.railway.app/mcp

The server is designed for machine discovery and includes server.json metadata for the official MCP Registry.

Why call RECOVER?

Retry libraries answer how to retry. RECOVER answers the more important question first: what is the safest next action after this specific failure?

Good call sites include API clients, AI agents, browser automations, workflow engines, MCP hosts, job runners, payment/order flows, and any system where blindly retrying can duplicate a side effect or amplify a failure.

Analytics

GET /activity displays durable, privacy-safe usage telemetry and a permanent FIRST 10 REAL-WORLD STRANGER CONVERSIONS scoreboard. Real-use events are stored separately so discovery traffic cannot push milestones out of history. Raw IPs and request payloads are not stored.

Deploy

The repo is Railway-ready with Dockerfile and railway.toml. Mount a persistent volume at /data so the permanent real-use ledger survives restarts.

來源：README.md，提交 9409191

工具

1

recover_decide

Use immediately after an API, MCP tool, automation, or agent action fails and before retrying. Especially use after timeouts, 5xx/429 responses, uncertain execution, or any side-effecting action that may already have completed. Returns the safest deterministic next action: RETRY_NOW, WAIT, REPAIR_REQUEST, VERIFY_FIRST, ESCALATE, or ABORT. Do not use before an action or for successful actions.

輸入參數errormethodstatusattemptheaderssideEffectmaxAttemptsidempotencyKeyproviderRetryableuncertainExecution

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。