ipvolt Proxy Toolkit
Proxy guides, tested configurations and error diagnostics, with an optional local route check.
使うべきか
品質と安全性
A
検出事項（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-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
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 4 件
検証済みバージョンは記録されていませんツール 4 件