网络智能查询服务

NetMCP是一个开源的MCP服务器集合,为AI代理提供结构化的网络标准、设备数据库和安全数据访问。

  • by cheenu1092-oss
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 cheenu1092-oss/netmcp

使用说明

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 作为指导方针。

许可证

麻省理工学院——随心所欲地使用它。