用途:该 MCP 服务用于对接 Nautobot 源数据平台(Source of Truth),对外提供只读的 IPAM 查询能力,适合在排查 IP 归属、审计地址分配、核对 VRF 与站点子网等场景中使用。
主要能力:工具包括 get_ip_addresses(按 address、prefix、status、role、tenant、vrf、limit、offset 过滤 IP)、get_prefixes(按 prefix、site、role、status、tenant、vrf 过滤前缀)、get_ip_address_by_id(按 UUID 取具体 IP)、search_ip_addresses(按任意文本全文检索 IP,默认 50,上限 500)、test_connection(验证 API 连通性,返回状态、URL 与时间戳)。
使用方式:以 stdio 传输运行(Python MCP SDK),也支持在可配置端口上以 HTTP 方式运行。需设置环境变量 NAUTOBOT_URL 与 NAUTOBOT_TOKEN(需具读权限);HTTP 模式下可选 MCP_PORT(默认 8000)与 MCP_HOST(默认 127.0.0.1)。要求 Python 3.13 及以上。
典型流程:审计时可先 test_connection,再按站点查前缀、按前缀查 IP、按 status=deprecated 找陈旧分配;查某 IP 时先全文检索,再按 ID 取详情,并结合前缀确认子网与站点;VRF 核对时分别取 VRF 内 IP 与前缀并检查重叠。
限制:所有工具均为只读,不会写入 Nautobot;大数据集需用 limit/offset 分页,单次上限 1000;网络存在地址重叠时务必按 VRF 过滤;多租户实例需按 tenant 过滤。发生超时、主机不可达或响应异常时,应直接向用户报告错误信息,不得编造结果。安装命令、仓库地址与更细的配置参数暂未在此资料中提供。