SuperAPI AI 工具集

nmap-network-scan

安全与审计

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能封装 nmap 能力,用于主机发现与端口扫描,包括 ICMP/TCP 主机发现、ARP 主机发现、常见端口快速扫描、SYN 半开扫描、TCP 全连接扫描和 UDP 端口扫描,适合子网存活探测、开放端口排查、防火墙规则验证、变更前后端口扫描以及 RFC1918 或实验网络资产发现。

主要能力与权限:nmap_ping_scan 做 ICMP+TCP 主机发现(无端口扫描,无需特权);nmap_arp_discovery 做局域网 ARP 发现(需要 cap_net_raw);nmap_top_ports 快速扫描最常见的前 N 个端口(无需特权);nmap_syn_scan 为 SYN 半开扫描(需要 cap_net_raw);nmap_tcp_scan 为完整 TCP 连接扫描(无需 root);nmap_udp_scan 扫描 UDP 服务,如 DNS、SNMP、NTP 等(需要 cap_net_raw)。

使用方式:通过 MCP 调用脚本执行,通用形式为 python3 $MCP_CALL "python3 -u $NMAP_MCP_SCRIPT" TOOL_NAME '{"param":"value"}'。典型流程为先做主机发现,例如 nmap_ping_scan 目标 192.168.1.0/24;直连局域网可用 nmap_arp_discovery;随后用 nmap_top_ports 扫描常用端口,如 count 100;需要更深入时用 nmap_syn_scan(默认端口范围 1-1024,可用 common 表示前 1000)或 nmap_tcp_scan(默认 1-1024);UDP 可用 nmap_udp_scan 指定端口如 53,67,68,69,123,161,162,500,514,1900。各工具均需 target,支持 IP、主机名或 CIDR 范围。

输出与限制:结果返回结构化 JSON,含 scan_id、target、hosts_up/per_host、count/total_open,可经 nmap_list_scans、nmap_get_scan 检索。所有目标须通过 config.yaml 的 CIDR 允许清单校验,默认含回环、RFC1918 与 IPv6 ULA,范围外直接拒绝。建议先主机发现再扫描大范围;UDP 扫描本身较慢,应精简端口列表;每次扫描均记录审计日志。若调用出现认证或连接错误,先确认 NMAP_MCP_SCRIPT 有效;工具报错时直接向用户报告错误信息,不要臆测结果。