ipvolt Proxy Toolkit
Proxy guides, tested configurations and error diagnostics, with an optional local route check.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- HIGH
- MEDIUMen generate_proxy_config
- INFOen generate_proxy_config
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"proxy-toolkit": {
"command": "npx",
"args": [
"@ipvolt/proxy-toolkit-mcp"
]
}
}
}Paquetes ejecutables
0.1.0stdioPuntos de conexión remotos
https://mcp.ipvolt.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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
}Comunidad
Evidencia