AI导哈

自愈代理服务

SelfHeal MCP是一款为MCP服务器设计的自愈代理工具，提供自动重试、断路器保护和调用可观测性功能，帮助AI代理应对不可靠的API。

  • by carsonroell-debug
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 carsonroell-debug/selfheal-mcp

使用说明

SelfHeal MCP

MCP服务器的自愈代理。使用自动重试、断路器保护和调用可观察性包装任何MCP工具调用。

你的人工智能代理停止破坏古怪的API。

一键安装： 在MCPize上安装 | npx selfheal-mcp

特性

  • 使用回退重试 --指数回退+瞬态故障抖动（5xx、超时、速率限制）
  • 断路器 --按目标断路器停止锤击死服务
  • 通话指标 --按工具和目标细分的成功率、延迟、错误频率
  • 代理模式 --透明地包裹任何现有的MCP服务器
  • 零配置 --独立工作，开箱即用，代理模式配置文件

快速开始

单独模式

添加到您的Claude桌面/Claude代码配置中：

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

然后使用 wrap_call 要发出任何具有自愈功能的HTTP请求：

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

代理模式

创建 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"
      }
    }
  }
}

所有工具来自 my-server 通过内置的自我修复功能重新暴露。

工具

工具 说明
wrap_call 使用重试+断路器执行HTTP调用
circuit_status 检查任何目标的健康状况
circuit_reset 修复问题后重置断路器
metrics 成功率、延迟、最大错误
recent_errors 最近的故障及其详细信息

添加代理模式

工具 说明
selfheal_metrics 所有代理呼叫的指标
selfheal_circuits 所有目标的电路状态
selfheal_recent_errors 所有目标最近发生的错误

配置

环境变量

变量 默认值 描述
SELFHEAL_CONFIG ./selfheal.config.json 配置文件路径
SELFHEAL_MAX_RETRIES 3 最大重试次数
SELFHEAL_BASE_DELAY_MS 1000 回退的基本延迟
SELFHEAL_MAX_DELAY_MS 30000 最大延迟上限
SELFHEAL_CIRCUIT_THRESHOLD 5 电路断开前的故障
SELFHEAL_CIRCUIT_COOLDOWN_MS 120000 半开试验前冷却

运作原理

Agent → SelfHeal MCP → [Retry + Circuit Breaker] → Target API/MCP Server
                ↓
          Metrics Collector
  1. 请求到达 --代理调用工具
  2. 电路检查 --如果目标失败次数太多，请立即拒绝
  3. 重试执行 --尝试调用，在出现指数回退的瞬态错误时重试
  4. 记录指标 --记录成功/失败、持续时间、尝试次数
  5. 更新电路 --跟踪每个目标的连续故障

安装

MCPize（推荐）

使用托管主机一键安装： 在MCPize上安装

npm

npx selfheal-mcp

PyPI

不适用——这是一个TypeScript服务器。关于Python的替代方案，请参见 LeadEnrich MCP.

许可证

麻省理工学院-由 自由工程师

相关

相关 MCP