ipvolt Proxy Toolkit

Proxy guides, tested configurations and error diagnostics, with an optional local route check.

我该使用它吗

质量与安全性

A
描述质量
95%
模式完整度
87%
命名质量
95%
投毒风险
80%
权限匹配度
100%
协议合规性
100%

发现(3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'generate_proxy_config' description contains placeholder text在 generate_proxy_config 中
  • INFOTool description contains placeholder or incomplete text在 generate_proxy_config 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,719token 数(工具定义)
~7.3 KB典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.12%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中:

{
  "mcpServers": {
    "proxy-toolkit": {
      "command": "npx",
      "args": [
        "@ipvolt/proxy-toolkit-mcp"
      ]
    }
  }
}

可运行的软件包

npm@ipvolt/proxy-toolkit-mcp0.1.0stdio

远程端点

https://mcp.ipvolt.com/mcpstreamable-http

它能做什么

工具清单

工具(4)

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢search_proxy_docs(query, topic, limit)

Find reviewed ipvolt public guides and articles. Returns canonical document IDs, excerpts and content revision. Submit a short topic query, never credentials or logs.

输入模式

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "topic": {
      "type": "string",
      "enum": [
        "setup",
        "troubleshooting",
        "concepts",
        "countries",
        "analysis"
      ]
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

输出模式

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 160,
            "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "description": {
            "type": "string",
            "maxLength": 1000
          },
          "reviewedAt": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "topic": {
            "type": "string",
            "enum": [
              "setup",
              "troubleshooting",
              "concepts",
              "countries",
              "analysis"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "snippet": {
            "type": "string"
          },
          "score": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "title",
          "description",
          "reviewedAt",
          "topic",
          "url",
          "sha256",
          "snippet",
          "score"
        ],
        "additionalProperties": false
      }
    },
    "provenance": {
      "type": "object",
      "properties": {
        "sourceRelease": {
          "type": "string"
        },
        "bundleSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "generatedAt": {
          "type": "string"
        }
      },
      "required": [
        "sourceRelease",
        "bundleSha256",
        "generatedAt"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "results",
    "provenance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_proxy_doc(documentId, section, cursor)

Read a bounded chunk or named section using a document ID returned by search_proxy_docs. Follow nextCursor to continue; cursors are bound to the content revision.

输入模式

{
  "type": "object",
  "properties": {
    "documentId": {
      "type": "string",
      "maxLength": 160,
      "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "section": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "cursor": {
      "type": "string",
      "pattern": "^[a-f0-9]{16}:\\d{1,5}$"
    }
  },
  "required": [
    "documentId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

输出模式

{
  "type": "object",
  "properties": {
    "document": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 160,
          "pattern": "^\\/(guides|blog)\\/[a-z0-9]+(?:-[a-z0-9]+)*$"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 250
        },
        "description": {
          "type": "string",
          "maxLength": 1000
        },
        "reviewedAt": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "topic": {
          "type": "string",
          "enum": [
            "setup",
            "troubleshooting",
            "concepts",
            "countries",
            "analysis"
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "id",
        "title",
        "description",
        "reviewedAt",
        "topic",
        "url",
        "sha256"
      ],
      "additionalProperties": false
    },
    "markdown": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "chunk": {
      "type": "number"
    },
    "totalChunks": {
      "type": "number"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "provenance": {
      "type": "object",
      "properties": {
        "sourceRelease": {
          "type": "string"
        },
        "bundleSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "generatedAt": {
          "type": "string"
        }
      },
      "required": [
        "sourceRelease",
        "bundleSha256",
        "generatedAt"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "document",
    "markdown",
    "sections",
    "chunk",
    "totalChunks",
    "nextCursor",
    "provenance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢generate_proxy_config(client, version, protocol, timeoutSeconds)

Generate an HTTPS GET example for an exact tested curl, Requests, HTTPX or Playwright APIRequestContext version. Credentials and target are local environment placeholders. It does not execute the example or configure other agent tools.

输入模式

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ],
      "description": "Client whose exact tested configuration to generate."
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ],
      "description": "Exact tested version matching the client. Other versions are unsupported."
    },
    "protocol": {
      "default": "http",
      "description": "HTTP proxy with HTTPS CONNECT. Other proxy protocols are not tested.",
      "type": "string",
      "const": "http"
    },
    "timeoutSeconds": {
      "default": 15,
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "required": [
    "client",
    "version"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

输出模式

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "protocol": {
      "type": "string",
      "const": "http"
    },
    "templateRevision": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "sh",
        "python",
        "javascript"
      ]
    },
    "interface": {
      "type": "string"
    },
    "testedRuntime": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "maxLength": 16384
    },
    "environment": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "secret": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "required",
          "secret",
          "description"
        ],
        "additionalProperties": false
      }
    },
    "behavior": {
      "type": "object",
      "properties": {
        "method": {
          "type": "string",
          "const": "GET"
        },
        "followsRedirects": {
          "type": "boolean",
          "const": false
        },
        "automaticRetries": {
          "type": "number",
          "const": 0
        },
        "bypassesProxy": {
          "type": "boolean",
          "const": false
        },
        "verifiesTargetTls": {
          "type": "boolean",
          "const": true
        },
        "output": {
          "type": "string"
        },
        "timeoutSeconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 60
        },
        "timeoutScope": {
          "type": "string"
        }
      },
      "required": [
        "method",
        "followsRedirects",
        "automaticRetries",
        "bypassesProxy",
        "verifiesTargetTls",
        "output",
        "timeoutSeconds",
        "timeoutScope"
      ],
      "additionalProperties": false
    },
    "limitations": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "summary": {
      "type": "string"
    },
    "sources": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "client",
    "version",
    "protocol",
    "templateRevision",
    "language",
    "interface",
    "testedRuntime",
    "code",
    "environment",
    "behavior",
    "limitations",
    "summary",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢diagnose_proxy_error(client, version, phase, status, exception, ...)

Use structured client/version, phase, status or exception observations to identify possible causes and the next check. Returns uncertainty and retry boundaries. Do not send raw logs, URLs or credentials.

输入模式

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "phase": {
      "type": "string",
      "enum": [
        "configuration",
        "pool",
        "proxy_connect",
        "connect_tunnel",
        "target_tls",
        "request_send",
        "response_headers",
        "response_body",
        "unknown"
      ]
    },
    "status": {
      "description": "Observed HTTP status; identify its responding layer separately.",
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "exception": {
      "description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.",
      "type": "string",
      "enum": [
        "proxy_error",
        "tls_error",
        "connect_timeout",
        "read_timeout",
        "write_timeout",
        "pool_timeout",
        "connection_refused",
        "dns_error",
        "connection_reset",
        "protocol_error",
        "timeout",
        "invalid_configuration",
        "unknown"
      ]
    },
    "responseSource": {
      "default": "unknown",
      "description": "Use target/proxy only when established by response provenance, not merely the status code.",
      "type": "string",
      "enum": [
        "proxy",
        "target",
        "unknown"
      ]
    },
    "method": {
      "default": "unknown",
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "OPTIONS",
        "PUT",
        "DELETE",
        "POST",
        "PATCH",
        "unknown"
      ]
    },
    "requestMayHaveBeenSent": {
      "description": "Whether this target request may already have reached the application. Omit when unknown.",
      "type": "boolean"
    },
    "retryAfterSeconds": {
      "description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.",
      "type": "integer",
      "minimum": 0,
      "maximum": 86400
    }
  },
  "required": [
    "client",
    "version",
    "phase"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

输出模式

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "curl",
        "requests",
        "httpx",
        "playwright"
      ]
    },
    "version": {
      "type": "string",
      "enum": [
        "8.22.0",
        "2.34.2",
        "0.28.1",
        "1.63.0"
      ]
    },
    "rulesRevision": {
      "type": "string"
    },
    "evidence": {
      "type": "object",
      "properties": {
        "client": {
          "type": "string",
          "enum": [
            "curl",
            "requests",
            "httpx",
            "playwright"
          ]
        },
        "version": {
          "type": "string",
          "enum": [
            "8.22.0",
            "2.34.2",
            "0.28.1",
            "1.63.0"
          ]
        },
        "phase": {
          "type": "string",
          "enum": [
            "configuration",
            "pool",
            "proxy_connect",
            "connect_tunnel",
            "target_tls",
            "request_send",
            "response_headers",
            "response_body",
            "unknown"
          ]
        },
        "status": {
          "description": "Observed HTTP status; identify its responding layer separately.",
          "type": "integer",
          "minimum": 100,
          "maximum": 599
        },
        "exception": {
          "description": "Normalized category, not raw exception text. HTTPX ConnectError alone does not establish a TLS error.",
          "type": "string",
          "enum": [
            "proxy_error",
            "tls_error",
            "connect_timeout",
            "read_timeout",
            "write_timeout",
            "pool_timeout",
            "connection_refused",
            "dns_error",
            "connection_reset",
            "protocol_error",
            "timeout",
            "invalid_configuration",
            "unknown"
          ]
        },
        "responseSource": {
          "default": "unknown",
          "description": "Use target/proxy only when established by response provenance, not merely the status code.",
          "type": "string",
          "enum": [
            "proxy",
            "target",
            "unknown"
          ]
        },
        "method": {
          "default": "unknown",
          "type": "string",
          "enum": [
            "GET",
            "HEAD",
            "OPTIONS",
            "PUT",
            "DELETE",
            "POST",
            "PATCH",
            "unknown"
          ]
        },
        "requestMayHaveBeenSent": {
          "description": "Whether this target request may already have reached the application. Omit when unknown.",
          "type": "boolean"
        },
        "retryAfterSeconds": {
          "description": "Parsed bounded Retry-After delay, if actually observed. Never submit the raw header.",
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        }
      },
      "required": [
        "client",
        "version",
        "phase",
        "responseSource",
        "method"
      ],
      "additionalProperties": false
    },
    "summary": {
      "type": "string"
    },
    "candidates": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "confidence": {
            "type": "string",
            "enum": [
              "supported",
              "possible"
            ]
          },
          "explanation": {
            "type": "string"
          },
          "nextCheck": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "confidence",
          "explanation",
          "nextCheck"
        ],
        "additionalProperties": false
      }
    },
    "uncertainty": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "retry": {
      "type": "object",
      "properties": {
        "automaticRetryRecommended": {
          "type": "boolean",
          "const": false
        },
        "category": {
          "type": "string",
          "enum": [
            "reconcile_before_repeating",
            "bounded_retry_after_cause_check"
          ]
        },
        "advice": {
          "type": "string"
        }
      },
      "required": [
        "automaticRetryRecommended",
        "category",
        "advice"
      ],
      "additionalProperties": false
    },
    "sources": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "client",
    "version",
    "rulesRevision",
    "evidence",
    "summary",
    "candidates",
    "uncertainty",
    "retry",
    "sources"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

社区

评价此服务器

证据

最近观测

已验证未记录版本4 个工具
已验证未记录版本4 个工具
已验证未记录版本4 个工具
已验证未记录版本4 个工具
已验证未记录版本4 个工具
已验证未记录版本4 个工具
已验证未记录版本4 个工具