Packetrove

将 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/mcp
Claude Code MCP 官方文档

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
Codex 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 表示缺少可信的连接信息,请勿推测地址。

阅读仓库中的 MCP 技术指南(英文)