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 textgenerate_proxy_config에서
  • INFOTool description contains placeholder or incomplete textgenerate_proxy_config에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,719토큰 (도구 정의)
~7.3 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.12%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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개