API代理自愈工具

ProxyPI是一个自愈API代理MCP,用于Cursor、Claude Code或任何MCP兼容客户端,能够自动诊断和修复失败的REST请求。

  • by AlexisLspk
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AlexisLspk/proxypi-mcp

使用说明

这是什么

Cursor、Claude Code或任何MCP-兼容客户端的自密封API代理MCP。发送任何REST请求——如果失败,ProxyPI会读取错误,使用Claude诊断问题,修补请求,然后重试。成功的修复会被记住,并在下次立即应用,而无需致电克劳德。


运作原理

You: proxypi_request → POST https://api.example.com/users

ProxyPI:  try → fail → diagnose (Claude) → patch → retry → remember

下次在同一主机和路径上发生相同的错误时,会立即从内存中应用修复程序,无需调用Claude。


演示

npx proxypi
▶ proxypi  sending → POST https://api.example.com/users
⚠ proxypi  422 — checking memory for known fix...
▶ proxypi  healing attempt 1 — asking Claude to diagnose...
▶ proxypi  retrying with patch: body uses 'name' but API expects 'full_name'
✔ proxypi  healed in 1 attempt — 200 — 1843ms

安装

npx proxypi

配置

增添 .cursor/mcp.json (项目根或 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "proxypi": {
      "command": "npx",
      "args": ["-y", "proxypi"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

重新启动游标。四种工具: proxypi_request, proxypi_history, proxypi_replay, proxypi_clear.


工具

工具 说明
proxypi_request 发送任何REST请求——失败时自动修复
proxypi_history 查看过去的修复,按API主机筛选
proxypi_replay 重新运行已存储的修复程序以验证其是否仍然有效
proxypi_clear 从内存中清除所有治疗记录

ProxyPI可以修复什么

错误 ProxyPI的作用
401 Unauthorized 修复了授权标头格式(承载、基本和令牌前缀)
400 Bad Request 修复正文字段名称、类型或缺少的必填字段
422 Unprocessable 更正架构不匹配、枚举值、日期格式
404 Not Found 修复了URL路径、API版本前缀、尾部斜杠
405 Method Not Allowed 切换到正确的HTTP方法

更多

  • 内存: 修复程序存储在 ~/.proxypi/memory.json
  • 环境: ANTHROPIC_API_KEY 必需的(仅当使用修复时——服务器在没有修复的情况下启动)
  • 本地开发人员: cp .env.example .env,添加密钥,然后 npm run dev
  • 测验: npm test

麻省理工学院· GitHub