English Français العربية

SelfHeal MCP

السجل الرسمي السحابة وDevOps

Self-healing proxy for MCP servers with retry, circuit breaker, and observability

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع SelfHeal MCP؟

  • Retry with backoff — Exponential backoff + jitter on transient failures (5xx, timeouts, rate limits)
  • Circuit breaker — Per-target circuit breaker stops hammering dead services
  • Call metrics — Success rates, latency, error frequency, broken down by tool and target
  • Proxy mode — Wrap any existing MCP server transparently
  • Zero config — Works standalone out of the box, config file for proxy mode

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package selfheal-mcp
Claude Code 
claude mcp add selfheal-mcp -e 'SELFHEAL_CONFIG=<SELFHEAL_CONFIG>' -e 'SELFHEAL_MAX_RETRIES=<SELFHEAL_MAX_RETRIES>' -e 'SELFHEAL_CIRCUIT_THRESHOLD=<SELFHEAL_CIRCUIT_THRESHOLD>' -- npx -y selfheal-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "selfheal-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "selfheal-mcp@0.1.1"
            ],
            "env": {
                "SELFHEAL_CONFIG": "<SELFHEAL_CONFIG>",
                "SELFHEAL_MAX_RETRIES": "<SELFHEAL_MAX_RETRIES>",
                "SELFHEAL_CIRCUIT_THRESHOLD": "<SELFHEAL_CIRCUIT_THRESHOLD>"
            }
        }
    }
}

متغيرات البيئة

  • SELFHEAL_CONFIG Path to selfheal.config.json (optional, defaults to cwd)
  • SELFHEAL_MAX_RETRIES Max retry attempts per call (default: 3)
  • SELFHEAL_CIRCUIT_THRESHOLD Failures before circuit opens (default: 5)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SelfHeal MCP
  2. Features
  3. Quick Start
  4. Tools
  5. Configuration
  6. How It Works
  7. Install
  8. License
  9. Related

SelfHeal MCP

Self-healing proxy for MCP servers. Wraps any MCP tool call with automatic retry, circuit breaker protection, and call observability.

Your AI agents stop breaking on flaky APIs.

One-click install: Install on MCPize | npx selfheal-mcp

Features

  • Retry with backoff — Exponential backoff + jitter on transient failures (5xx, timeouts, rate limits)
  • Circuit breaker — Per-target circuit breaker stops hammering dead services
  • Call metrics — Success rates, latency, error frequency, broken down by tool and target
  • Proxy mode — Wrap any existing MCP server transparently
  • Zero config — Works standalone out of the box, config file for proxy mode

Quick Start

Standalone Mode

Add to your Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "selfheal": {
      "command": "npx",
      "args": ["-y", "selfheal-mcp"]
    }
  }
}

Then use wrap_call to make any HTTP request with self-healing:

Use the wrap_call tool to GET https://api.example.com/data with target "example-api"
Proxy Mode

Create selfheal.config.json:

{
  "mode": "proxy",
  "targets": [
    {
      "name": "my-server",
      "transport": "streamable-http",
      "url": "https://my-mcp-server.com/mcp"
    }
  ]
}
{
  "mcpServers": {
    "selfheal": {
      "command": "npx",
      "args": ["-y", "selfheal-mcp"],
      "env": {
        "SELFHEAL_CONFIG": "/path/to/selfheal.config.json"
      }
    }
  }
}

All tools from my-server are re-exposed with self-healing built in.

Tools

ToolDescription
wrap_callExecute HTTP call with retry + circuit breaker
circuit_statusCheck health of any target
circuit_resetReset circuit breaker after fixing issues
metricsSuccess rates, latency, top errors
recent_errorsRecent failures with full details
Proxy Mode Adds
ToolDescription
selfheal_metricsMetrics for all proxied calls
selfheal_circuitsCircuit status for all targets
selfheal_recent_errorsRecent errors across all targets

Configuration

Environment Variables
VariableDefaultDescription
SELFHEAL_CONFIG./selfheal.config.jsonConfig file path
SELFHEAL_MAX_RETRIES3Max retry attempts
SELFHEAL_BASE_DELAY_MS1000Base delay for backoff
SELFHEAL_MAX_DELAY_MS30000Max delay cap
SELFHEAL_CIRCUIT_THRESHOLD5Failures before circuit opens
SELFHEAL_CIRCUIT_COOLDOWN_MS120000Cooldown before half-open test

How It Works

Agent → SelfHeal MCP → [Retry + Circuit Breaker] → Target API/MCP Server
                ↓
          Metrics Collector
  1. Request arrives — Agent calls a tool
  2. Circuit check — If target has failed too many times, reject immediately
  3. Execute with retry — Try the call, retry on transient errors with exponential backoff
  4. Record metrics — Log success/failure, duration, attempts
  5. Update circuit — Track consecutive failures per target

Install

One-click install with managed hosting: Install on MCPize

npm
npx selfheal-mcp
PyPI

Not applicable — this is a TypeScript server. For Python alternatives, see LeadEnrich MCP.

License

MIT — Built by Freedom Engineers

الأسئلة الشائعة

ما هو SelfHeal MCP؟

Self-healing proxy for MCP servers with retry, circuit breaker, and observability

كيف أثبّت SelfHeal MCP؟

يعمل على جهازك. في Claude Code: claude mcp add selfheal-mcp -e 'SELFHEAL_CONFIG=<SELFHEAL_CONFIG>' -e 'SELFHEAL_MAX_RETRIES=<SELFHEAL_MAX_RETRIES>' -e 'SELFHEAL_CIRCUIT_THRESHOLD=<SELFHEAL_CIRCUIT_THRESHOLD>' -- npx -y selfheal-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SelfHeal MCP إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل SelfHeal MCP مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون SelfHeal MCP؟

ينشره carsonroell-debug. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.