ipvolt Proxy Toolkit

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

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
95%
Integridad del esquema
87%
Calidad de los nombres
95%
Riesgo de envenenamiento
80%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (3)

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

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,719Tokens (definiciones de herramientas)
~7.3 KBTamaño de respuesta típico
Impacto significativo en la atención (2.12% del contexto de 128k)

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

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

Puntos de conexión remotos

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

Qué puede hacer

Inventario de herramientas

Herramientas (4)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas