ipvolt Proxy Toolkit
Proxy guides, tested configurations and error diagnostics, with an optional local route check.
我该使用它吗
质量与安全性
发现(3)
- HIGH
- MEDIUM在 generate_proxy_config 中
- INFO在 generate_proxy_config 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"proxy-toolkit": {
"command": "npx",
"args": [
"@ipvolt/proxy-toolkit-mcp"
]
}
}
}可运行的软件包
0.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
}社区
证据