将 Packetrove 接入 AI 智能体
连接兼容 MCP 的客户端,计算覆盖 CIDR 或查看该客户端连接的公网地址。先按下方步骤接入,再参考工具示例。
Streamable HTTP · 无需账户或 API 密钥
https://api.packetrove.com/mcp
连接客户端
安装 Claude Code 或 Codex 后,添加这个远程服务器。以下命令配置客户端,不会安装本地 Packetrove 服务器。
Claude Code
claude mcp add --transport http --scope user packetrove \ https://api.packetrove.com/mcpClaude Code MCP 官方文档
在客户端中使用 /mcp 检查连接,确认 smallest_covering_cidr 和 public-ip 已可用。
完成配置后,客户端通过 tools/list 发现工具,并根据工具描述和参数结构选择调用。阅读网页不会自动配置客户端或授予工具访问权限。
通过 MCP 使用计算器
让 AI 智能体为选定的一组防火墙允许列表或拦截列表条目计算单个覆盖 CIDR,并解释额外覆盖范围。
工具名称: smallest_covering_cidr
服务器地址: https://api.packetrove.com/mcp
Streamable HTTP · 无需账户或 API 密钥
接受 1 至 1,000 个 IPv4 或 IPv6 地址或 CIDR,每项最多 64 个字符。每次调用只使用一种地址族。
示例参数
{
"inputs": [
"203.0.113.1",
"203.0.113.2",
"203.0.113.6"
]
}使用文档专用地址的示例结果
{
"family": "ipv4",
"normalizedInputs": [
"203.0.113.1/32",
"203.0.113.2/32",
"203.0.113.6/32"
],
"cidr": "203.0.113.0/29",
"range": {
"first": "203.0.113.0",
"last": "203.0.113.7"
},
"inputAddressCount": "3",
"coveredAddressCount": "8",
"additionalAddressCount": "5"
}通过 cidr 和 range 查看覆盖网段。在修改防火墙规则前检查 additionalAddressCount。所有地址数均为十进制字符串,保持 IPv6 计数精确。
远程 MCP 调用会将输入发送到服务器;网页计算器在浏览器内运行。本工具为给定输入计算一个 CIDR;要选择多个合并组合以满足整张名单的条目限制,需要另行确定目标。本工具不会修改防火墙规则。
打开浏览器计算器通过 MCP 查看连接地址
让 AI 智能体查看发起本次 MCP 工具调用的连接所使用的公网 IP。
工具名称: public-ip
服务器地址: https://api.packetrove.com/mcp
Streamable HTTP · 无需账户或 API 密钥
传入空对象 {}。工具观察当前请求的连接,不接受待查询的 IP 地址参数。
示例参数
{}使用文档专用地址的示例结果
{
"ip": "203.0.113.1",
"family": "ipv4"
}示例使用文档专用地址。实际调用会返回本次请求观察到的 ip 和地址族 family,其值为 ipv4 或 ipv6。
托管 AI 客户端可能返回它自己的出口地址。要查看浏览器连接,请使用本网页工具;要查看电脑的命令行连接,请在该电脑上运行 CLI。一次调用不能同时发现两种地址族、本地私有地址或代理之前的地址。查询结果不能证明客户端身份。
查询浏览器的公网 IP读取结果与处理错误
读取 structuredContent,或解析文本内容块中的 JSON。地址计数应保留为十进制字符串或任意精度整数;将很大的 IPv6 计数转换为浮点数会丢失精度。
isError 为 true 时,先读取错误 JSON,再决定是否重试。根据用户提供的信息修正 INVALID_INPUT 和 MIXED_ADDRESS_FAMILIES。CLIENT_IP_UNAVAILABLE 表示缺少可信的连接信息,请勿推测地址。