MCP Vanguard (Skyvanguard)

mcp前锋

 ](https://nodejs.org/)    

一个安全渗透测试MCP服务器 89工具 穿过 10个类别 克劳德整合。本机功能 Windows/WSL网桥 从任何终端使用Kali Linux工具——零新的npm依赖。

特性

• 89安全工具 涵盖10个类别：侦察、网络、OSINT、网络、漏洞利用、加密、云、容器、分析和实用程序
• 注册表架构：具有自描述模式、权限和执行模式的自动发现工具
• WSL大桥：从Windows透明地执行Kali Linux工具（nmap、john、enum4linux等）
• 混合执行：原生Node.js、外部API、WSL子进程或自动回退
• 范围管理：防止扫描外部授权目标
• 权限级别：安全（被动）/危险（主动，需要范围）/受阻（未知）
• 报告生成：Markdown和JSON报告、差异比较、风险评分
• 攻击链检测：跨工具关联调查结果，以确定多步攻击路径
• 安全加固：输入净化、命令分配列表、审计日志记录、安全错误处理
• 缓存和速率限制：内置控制，实现高效安全的扫描

快速开始

git clone https://github.com/skyvanguard/mcp-vanguard.git
cd mcp-vanguard
npm install
npm run build
npm test

配置

添加到您的Claude MCP配置中：

克劳德桌面 (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vanguard": {
      "command": "node",
      "args": ["/path/to/mcp-vanguard/dist/index.js"]
    }
  }
}

克劳德代码 (.mcp.json 在项目根目录中）：

{
  "mcpServers": {
    "vanguard": {
      "command": "node",
      "args": ["C:/path/to/mcp-vanguard/dist/index.js"]
    }
  }
}

工具（共89个）

侦察（4个工具）

网络安全（10个工具）

网络和基础设施（15个工具）

OSINT（15个工具）

开采（10个工具）

密码和加密（8工具）

云安全（8个工具）

集装箱安全（5个工具）

分析和报告（9个工具）

实用程序（5个工具）

摘要

权限级别

使用示例

1.设置范围

vanguard_set_scope with targets: ["example.com", "*.example.com"]

2.被动侦察

vanguard_dns_records for example.com
vanguard_cert_search for example.com
vanguard_wayback for example.com
vanguard_ssl_check for example.com
vanguard_tech_detect for https://example.com
vanguard_asn_lookup for example.com
vanguard_favicon_hash for https://example.com

3.安全分析

vanguard_headers_check for https://example.com
vanguard_cors_check for https://api.example.com
vanguard_js_endpoints for https://example.com with deep: true
vanguard_cve_lookup for "nginx 1.20"
vanguard_crypto_audit for https://example.com

4.主动扫描（需要授权）

vanguard_subdomain_enum for example.com
vanguard_port_scan for example.com ports 1-1000
vanguard_service_detect for example.com ports [80, 443, 8080]
vanguard_nuclei_scan for https://example.com with severity ["high","critical"]
vanguard_sqli_test for https://example.com/search?q=test
vanguard_xss_test for https://example.com/search?q=test

5.云和集装箱检查

vanguard_s3_bucket_check for "company-backup"
vanguard_firebase_check for "my-project"
vanguard_subdomain_takeover for ["app.example.com", "api.example.com"]
vanguard_docker_socket for 10.0.0.5
vanguard_k8s_api for https://10.0.0.5:6443

6.分析和报告

vanguard_vuln_correlate with findings from multiple scans
vanguard_risk_score with context (public, auth, sensitive data)
vanguard_remediation_plan from findings
vanguard_diff_report comparing before/after scans
vanguard_report_gen with title "Security Assessment" and findings

发展

npm install        # Install dependencies
npm run build      # Build TypeScript
npm run dev        # Watch mode
npm test           # Run 178 tests
npm run test:coverage  # Coverage report
npm run format     # Format code

安全功能

输入消毒

• Shell元字符过滤
• 路径遍历预防
• URL验证（无凭据，无私有IP）
• 域/IP格式验证

指挥执行安全

• 命令允许列表：只有允许的命令才能通过WSL或Windows执行
• 论点逃逸：所有参数都已正确转义以供shell执行
• 超时保护：每个命令可配置超时

审计日志

• 所有工具调用都会记录时间戳和持续时间
• 跟踪安全事件（被阻止的命令、范围违规）
• 记录违反速率限制的行为
• 通过查看日志 vanguard_audit_stats

安全错误处理

• 对错误消息进行清理，以防止信息泄露
• 路径、IP和敏感数据在错误输出中被屏蔽
• 从面向用户的错误中删除堆栈跟踪

建筑

mcp-vanguard/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server + tool registration
│   ├── registry.ts           # ToolRegistry (auto-discover, permissions)
│   ├── config.ts             # Configuration + scope management
│   ├── types/
│   │   └── tool.ts           # ToolDefinition interface
│   ├── executor/
│   │   ├── windows.ts        # Windows executor (with allowlist)
│   │   └── wsl.ts            # WSL bridge (with allowlist)
│   ├── tools/
│   │   ├── recon/            # 4 reconnaissance tools
│   │   ├── web/              # 10 web security tools
│   │   ├── network/          # 15 network/infrastructure tools
│   │   ├── osint/            # 15 OSINT tools
│   │   ├── exploit/          # 10 exploitation tools
│   │   ├── crypto/           # 8 password & crypto tools
│   │   ├── cloud/            # 8 cloud security tools
│   │   ├── container/        # 5 container security tools
│   │   ├── analysis/         # 9 analysis & reporting tools
│   │   └── utils/            # 5 utility tools
│   └── utils/
│       ├── cache.ts          # Response caching
│       ├── rate-limiter.ts   # Rate limiting
│       ├── sanitizer.ts      # Input sanitization
│       ├── audit.ts          # Audit logging
│       ├── safe-error.ts     # Safe error handling
│       └── zod-to-json.ts    # Zod schema → JSON Schema
├── tests/                    # 178 Vitest tests
├── dist/                     # Compiled output
└── package.json

需求

可选（用于通过WSL进行主动扫描）：

• nmap、ffuf、nucleus、dig、john、enum4linux、smbclient、ldapsearch、ssh审计、arp扫描、snmpwalk、cewl、searchsploit

法律免责声明

警告：未经授权访问计算机系统是非法的。此工具用于 仅限授权安全测试在扫描任何目标之前，务必获得适当的书面授权。作者对误用不承担任何责任。

许可证

MIT许可证——见 许可证 了解详情。

作者

@skyvanguard