ipvolt Proxy Toolkit

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
95%
Vollständigkeit des Schemas
87%
Qualität der Benennung
95%
Risiko der Vergiftung
80%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'generate_proxy_config' description contains placeholder textin generate_proxy_config
  • INFOTool description contains placeholder or incomplete textin generate_proxy_config

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,719Tokens (Tool-Definitionen)
~7.3 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.12% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

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

Ausführbare Pakete

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

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (4)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

{
  "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
}

Ausgabe-Schema

{
  "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.

Eingabe-Schema

{
  "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
}

Ausgabe-Schema

{
  "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.

Eingabe-Schema

{
  "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
}

Ausgabe-Schema

{
  "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.

Eingabe-Schema

{
  "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
}

Ausgabe-Schema

{
  "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
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet4 Tools
verifiziertVersion nicht aufgezeichnet4 Tools