使用说明
NetMCP——人工智能代理的网络智能
开源MCP服务器,为AI代理提供对网络标准、设备数据库和安全数据的结构化访问。
免费自助主机 --通过Docker在本地运行,或作为AI编码工具中的MCP服务器运行。
→ 5分钟后开始 | 实时演示脚本 | 性能指南 | API费率限制 | MCP市场
这是什么?
帮助网络工程师的AI代理需要不断查找协议规范、设备信息和安全漏洞。现在,他们产生了RFC编号的幻觉,猜测端口分配,并错过了关键的CVE。
NetMCP通过将权威、免费、公共的网络数据库封装在 模型上下文协议 服务器——因此任何AI代理(Claude、GPT、Cursor、OpenClaw等)都可以直接查询它们。
包裹
| 包 | 数据源 | 记录 | 状态 |
|---|---|---|---|
oui-lookup |
IEEE-OUI(MAC→ 供应商) | 38K+制造商 | ✅ 完成 |
rfc-search |
IETF数据跟踪器 | 153K多个文档 | ✅ 完成 |
nvd-network-cves |
NIST NVD | 250000+CVE | ✅ 完成 |
fcc-devices |
联邦通信委员会设备认证 | 2万多名受让人 | ✅ 完成 |
threegpp-specs |
3GPP存档 | 5G/LTE标准 | ✅ 完成 |
iana-services |
IANA服务注册表 | 40+服务/端口 | ✅ 完成 |
dns-records |
IANA DNS RR类型 | 48种记录类型 | ✅ 完成 |
iana-media-types |
IANA媒体类型 | 80多种MIME类型 | ✅ 完成 |
whois-lookup |
WHOIS协议 | 域/IP/ASN查询 | ✅ 完成 |
建筑
graph TB
subgraph "AI Agents"
A1[Claude Code]
A2[Cursor]
A3[OpenClaw]
A4[Any MCP Client]
end
subgraph "MCP Protocol"
MCP[JSON-RPC 2.0<br/>stdio/HTTP transport]
end
subgraph "NetMCP Servers"
subgraph "oui-lookup"
OUI[4 tools<br/>local database<br/>instant response]
end
subgraph "rfc-search"
RFC[4 tools<br/>10s timeout<br/>5 req/10s rate limit]
end
subgraph "nvd-network-cves"
NVD[6 tools<br/>24hr cache<br/>5 req/30s rate limit<br/>15s timeout]
end
subgraph "fcc-devices"
FCC[4 tools<br/>10 req/10s rate limit<br/>15s timeout]
end
subgraph "threegpp-specs"
3GPP[4 tools<br/>curated + FTP<br/>10s timeout]
end
subgraph "iana-services"
IANA[5 tools<br/>local database<br/>instant response]
end
subgraph "dns-records"
DNS[4 tools<br/>local database<br/>instant response]
end
subgraph "iana-media-types"
MEDIA[5 tools<br/>local database<br/>instant response]
end
subgraph "whois-lookup"
WHOIS[5 tools<br/>domain/IP/ASN<br/>10s timeout]
end
end
subgraph "Data Sources"
DS1[(IEEE OUI<br/>38K+ manufacturers)]
DS2[(IETF Datatracker<br/>153K+ RFCs)]
DS3[(NIST NVD<br/>250K+ CVEs)]
DS4[(FCC API<br/>20K+ grantees)]
DS5[(3GPP Archive<br/>5G/LTE specs)]
DS6[(IANA Services<br/>40+ ports/protocols)]
DS7[(IANA DNS RR<br/>48 record types)]
DS8[(IANA Media Types<br/>80+ MIME types)]
DS9[(WHOIS Servers<br/>Domain registrars)]
end
A1 & A2 & A3 & A4 --> MCP
MCP --> OUI & RFC & NVD & FCC & 3GPP & IANA & DNS & MEDIA & WHOIS
OUI --> DS1
RFC --> DS2
NVD --> DS3
FCC --> DS4
3GPP --> DS5
IANA --> DS6
DNS --> DS7
MEDIA --> DS8
WHOIS --> DS9
classDef agent fill:#e1f5fe,stroke:#01579b,stroke-width:2px
classDef mcp fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef server fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
classDef source fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
class A1,A2,A3,A4 agent
class MCP mcp
class OUI,RFC,NVD,FCC,3GPP,IANA,DNS,MEDIA,WHOIS server
class DS1,DS2,DS3,DS4,DS5,DS6,DS7,DS8,DS9 source
主要特点:
- ⚡ 速率限制 -所有API调用包都具有线程安全速率限制器(防止API阻塞)
- 🔒 输入验证 --最大长度检查、格式验证、SQL注入保护
- ⏱️ 超时 --所有网络呼叫都有超时(10-15s)以防止挂起
- 💾 缓存 -NVD包具有24小时内存缓存(减少API负载,更快响应)
- ✅ 100%JSDoc覆盖率 --IDE自动补全和静态分析的完整类型注释
- 🧪 综合测试 --41次烟雾测试+34次集成测试(共75次)
- 🚀 生产就绪 --CI/CD、ESLint、npm workspaces,所有安全问题均已解决
使用它的4种方式
1.Docker(最简单——一个命令)
# Build the image
docker build -t netmcp:latest .
# Run any server
docker run -it netmcp:latest oui-lookup
# Or use Docker Compose
docker-compose up oui-lookup rfc-search nvd-network-cves
→ 完整的Docker指南 --包括MCP客户端配置、Kubernetes、生产部署
2.MCP服务器(克劳德代码、游标、OpenClaw、任何MCP客户端)
# Clone and run locally
git clone https://github.com/cheenu1092-oss/netmcp.git
cd netmcp/packages/oui-lookup
npm install && npm start
添加到MCP客户端配置中:
{
"mcpServers": {
"oui-lookup": {
"command": "node",
"args": ["packages/oui-lookup/src/index.js"]
},
"rfc-search": {
"command": "node",
"args": ["packages/rfc-search/src/index.js"]
},
"nvd-network-cves": {
"command": "node",
"args": ["packages/nvd-network-cves/src/index.js"]
},
"fcc-devices": {
"command": "node",
"args": ["packages/fcc-devices/src/index.js"]
},
"threegpp-specs": {
"command": "node",
"args": ["packages/threegpp-specs/src/index.js"]
},
"iana-services": {
"command": "node",
"args": ["packages/iana-services/src/index.js"]
},
"dns-records": {
"command": "node",
"args": ["packages/dns-records/src/index.js"]
},
"iana-media-types": {
"command": "node",
"args": ["packages/iana-media-types/src/index.js"]
},
"whois-lookup": {
"command": "node",
"args": ["packages/whois-lookup/src/index.js"]
}
}
}
3.OpenClaw/Claude代码技能
# Install as an OpenClaw skill
clawhub install jugaad-lab/oui-lookup
使用示例
在MCP客户端中配置后,您可以提出自然语言问题,AI将使用适当的工具:
OUI查找(MAC地址→ 供应商)
问: “谁制造了MAC地址为00:1A:2B:3C:4D:5E的设备?”
使用的工具: oui_lookup
答复:
{
"prefix": "001A2B",
"found": true,
"vendor": "Apple, Inc.",
"address": "1 Infinite Loop, Cupertino CA 95014, US"
}
问: “查找所有Cisco OUI”
使用的工具: oui_search
退货: 注册到Cisco的所有MAC前缀列表
RFC搜索(互联网标准)
问: “RFC 9293是关于什么的?”
使用的工具: rfc_get
答复:
{
"name": "RFC9293",
"title": "Transmission Control Protocol (TCP)",
"abstract": "This document specifies the Internet Transmission Control Protocol (TCP)...",
"status": "INTERNET STANDARD",
"published": "2022-08",
"url": "https://www.rfc-editor.org/rfc/rfc9293.html"
}
问: “查找有关QUIC的最新RFC”
使用的工具: rfc_search
退货: QUIC相关RFC列表,包括标题和链接
NVD网络CVE(安全漏洞)
问: “告诉我CVE-2023-44487(HTTP/2快速重置)的情况”
使用的工具: cve_get
答复:
{
"cve_id": "CVE-2023-44487",
"description": "HTTP/2 rapid reset vulnerability allows denial of service...",
"cvss_score": 7.5,
"severity": "HIGH",
"published": "2023-10-10",
"affected_products": ["nginx", "envoy", "apache-httpd", ...],
"references": [...]
}
问: “查找最近的WiFi漏洞”
使用的工具: cve_search
退货: 描述中提到“wifi”的CVE列表
演出 包括24小时缓存+速率限制。使用 cve_cache_stats 监测。
FCC设备(无线设备认证)
问: “苹果最近批准了哪些无线设备?”
使用的工具: fcc_search (按名称:“苹果”)
答复:
{
"query": "Apple",
"count": 143,
"results": [
{
"grantee_name": "Apple Inc.",
"grantee_code": "BCG",
"country": "United States",
"date_received": "2024-01-15"
},
...
]
}
问: “向我展示中国最近的FCC认证”
使用的工具: fcc_search (按国家:“中国”)
退货: 最近无线设备批准列表
3GPP规范(5G/LTE标准)
问: “3GPP规范23.501是关于什么的?”
使用的工具: spec_get
答复:
{
"number": "23.501",
"title": "System architecture for the 5G System (5GS)",
"series": "23_series",
"technology": "Core Network and Terminals",
"release": 16,
"status": "Under change control",
"url": "https://www.3gpp.org/ftp/Specs/archive/23_series/23.501/"
}
问: “查找有关网络切片的3GPP规范”
使用的工具: spec_search
退货: 标题中带有“切片”的规格列表(28.801、23.501等)
IANA服务(端口和协议查找)
问: “什么服务在端口443上运行?”
使用的工具: service_by_port
答复:
{
"port": 443,
"services": [
{
"name": "https",
"protocol": "tcp",
"description": "HTTP over TLS/SSL",
"assignee": "IETF",
"rfc": "RFC 2818"
}
]
}
问: “搜索VPN服务”
使用的工具: service_search
退货: VPN/隧道服务列表(IPsec、OpenVPN、L2TP)
DNS记录(资源记录类型)
问: “什么是DNS AAAA记录?”
使用的工具: record_by_name
答复:
{
"type": 28,
"name": "AAAA",
"description": "IPv6 address record",
"rfc": "RFC 3596",
"category": "Data"
}
问: “查找DNS安全记录类型”
使用的工具: record_search (关键字:“dnssec”)
退货: DNSKEY、RRSIG、NSEC、DS、NSEC3、TLSA等
IANA媒体类型(MIME类型查找)
问: “.webp文件的MIME类型是什么?”
使用的工具: media_by_extension
答复:
{
"extension": ".webp",
"media_type": "image/webp",
"description": "WebP image format",
"rfc": "WebP Specification",
"category": "image"
}
问: “显示所有视频格式”
使用的工具: media_by_category (类别:“视频”)
退货: video/mp4、video/webm、video/ogg、video/quicktime等。
WHOIS查询(域/IP/ASN智能)
问: “通过WHOIS查找example.com”
使用的工具: whois_lookup (通用查找,自动检测类型)
答复:
{
"query": "example.com",
"type": "domain",
"raw_output": "Domain Name: EXAMPLE.COM\nRegistrar: IANA\nCreation Date: 1995-08-14...",
"message": "WHOIS query successful"
}
问: “8.8.8.8的WHOIS信息是什么?”
使用的工具: whois_ip
退货: IP分配详细信息、网络范围、组织(谷歌有限责任公司)
问: “查找ASN 15169”
使用的工具: whois_asn
退货: 自治系统详细信息(谷歌有限责任公司、网络块、联系信息)
演出 查询公共WHOIS服务器,超时10秒。使用 whois_stats 监控查询类型和成功率。
为什么是这些数据源?
所有数据均为 自由、公开、权威:
- IEEE是的 --官方MAC地址供应商注册表(38K+制造商)
- IETF/RFC --所有互联网标准(153K+文档)
- NIST NVD --美国政府漏洞数据库(250000多个CVE)
- 催化裂化装置 --美国官方无线设备认证(20000多名受让人)
- 3GPP --全球5G/LTE/NR标准机构(5K+规格)
- IANA服务 --官方端口和协议号登记处(40+公共服务)
- IANA DNS RR类型 --官方DNS资源记录类型注册表(48种记录类型)
- IANA媒体类型 --官方MIME类型注册表(80+常见类型)
- WHOIS协议 --分布式域/IP/ASN注册数据库(RFC 3912)
不需要API密钥。没有利率限制问题。无刮擦灰色区域。
技术特性
- ✅ 100%JSDoc类型覆盖率 --IDE自动补全、静态分析
- ✅ 线程安全速率限制 -防止API在并发负载下节流
- ✅ 24小时缓存(NVD) -响应更快,API压力降低
- ✅ 全面的测试套件 --75次测试(41次烟雾+34次集成)
- ✅ 带有GitHub操作的CI/CD --Node.js 20.x、22.x、24.x上的测试
- ✅ ESLint+类型验证 --零错误,零警告
- ✅ npm工作区 --具有提升依赖关系的高效单仓库
- ✅ 生产就绪 --超时、错误处理、输入净化
建造于
Nagarjun Srinivasan --HPE Networking首席系统工程师,持有 美国专利10986606 关于无线信号强度方法。白天构建人工智能驱动的自动驾驶网络,晚上构建开源网络工具。
部分 游戏实验室 开源集体。
贡献
PR欢迎!看 贡献.md 作为指导方针。
许可证
麻省理工学院——随心所欲地使用它。