Sec Masscan MCP

Masscan MCP服务器

一种模型上下文协议（MCP）服务器 masscan -世界上最快的端口扫描仪，能够在6分钟内扫描整个互联网。

概述

此MCP服务器为AI助手使用masscan执行网络端口扫描提供了一个标准化的接口。它通过SSH在远程Kali Linux主机上执行命令，使其成为安全评估、网络发现和渗透测试工作流程的理想选择。

特性

安装

# Clone the repository
git clone https://github.com/schwarztim/sec-masscan-mcp.git
cd sec-masscan-mcp

# Install dependencies
npm install

# Build
npm run build

配置

MCP客户端配置

添加到您的Claude桌面配置(~/.claude/user-mcps.json 或同等）：

{
  "mcpServers": {
    "masscan": {
      "command": "node",
      "args": ["/path/to/sec-masscan-mcp/dist/index.js"],
      "env": {
        "KALI_HOST": "kali"
      }
    }
  }
}

环境变量

SSH设置

确保对Kali主机的无密码SSH访问：

# Generate SSH key if needed
ssh-keygen -t ed25519

# Copy to Kali host
ssh-copy-id kali

# Verify connection
ssh kali "masscan --version"

使用示例

基本端口扫描

{
  "tool": "masscan_scan",
  "arguments": {
    "targets": "192.168.1.0/24",
    "ports": "80,443,8080"
  }
}

带横幅抓取的高速扫描

{
  "tool": "masscan_scan",
  "arguments": {
    "targets": "10.0.0.0/8",
    "ports": "22,80,443",
    "rate": 10000,
    "banners": true
  }
}

快速Web服务扫描

{
  "tool": "masscan_quick_scan",
  "arguments": {
    "targets": "192.168.1.0/24",
    "preset": "web",
    "banners": true
  }
}

全端口扫描

{
  "tool": "masscan_quick_scan",
  "arguments": {
    "targets": "192.168.1.1",
    "preset": "full",
    "rate": 10000
  }
}

分布式扫描（分片）

{
  "tool": "masscan_scan",
  "arguments": {
    "targets": "10.0.0.0/8",
    "ports": "80,443",
    "shard": "1/3"
  }
}

恢复中断的扫描

{
  "tool": "masscan_resume",
  "arguments": {
    "configFile": "/tmp/paused.conf"
  }
}

端口预设

输出格式

高级选项

这 masscan_scan 该工具支持所有主要的masscan选项：

• 码率控制: rate -每秒数据包数（高达25M）
• 横幅抓取: banners -执行完整的TCP握手
• 除外条款: excludeTargets, excludeFile
• 网络优化: adapter, adapterIp, adapterMac, routerMac
• 时机: wait, retries, connectionTimeout
• 协议: ttl, sourcePort
• 分布式: seed, shard
• 输出: outputFormat, outputFile, openOnly

需求

• Node.js 18岁或以上
• SSH访问 安装了masscan的Kali Linux主机
• Root/sudo Kali上的高速扫描访问

安全考虑

• 仅扫描您有权测试的网络
• 高扫描速率会触发IDS/IPS警报
• 横幅抓取建立完整的TCP连接
• 考虑对敏感主机使用排除列表

参考文献

• Masscan手册页
• Kali Linux工具-Masscan
• 模型上下文协议

许可证

MIT许可证-请参阅 许可证 了解详情。