ipvolt Proxy Toolkit
Proxy guides, tested configurations and error diagnostics, with an optional local route check.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- HIGH
- MEDIUMin generate_proxy_config
- INFOin generate_proxy_config
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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
0.1.0stdioRemote-Endpunkte
https://mcp.ipvolt.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
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
Nachweis