MCP Vulnerability Scanner

MCP 漏洞扫描器

一个用于扫描 IP 地址漏洞的模型上下文协议（MCP）服务。该服务提供工具，可对单个 IP 或多个 IP 进行安全扫描。

功能

• 使用多种方法扫描 IP 地址漏洞：
  • Nmap 漏洞扫描
  • 基于 API 的漏洞检查
• 支持扫描单个 IP 或批量扫描多个 IP
• 返回详细报告，包含漏洞严重程度、描述和修复步骤
• 实现模型上下文协议，便于与 MCP 客户端集成

前提条件

• Node.js（v14.x 或更高版本）
• npm（v7.x 或更高版本）
• Nmap（可选，用于增强扫描能力）

安装

1. 克隆此仓库：

   git clone <repository-url>
   cd mcp-vulnerability-scanner
   

2. 安装依赖项：

   npm install
   

3. 安装 Nmap（可选，但推荐）：

   # For Ubuntu/Debian
   sudo apt-get update
   sudo apt-get install nmap
   
   # For CentOS/RHEL
   sudo yum install nmap
   
   # For macOS
   brew install nmap
   

配置

MCP 漏洞扫描器通过以下文件进行配置：

1. .mcp.json

这是主要的 MCP 配置文件：

{
  "name": "vulnerability-scanner",
  "version": "1.0.0",
  "description": "An MCP server for scanning vulnerabilities on IP addresses",
  "command": "npm",
  "args": ["run", "dev"],
  "capabilities": {
    "contextItemTypes": ["ip"]
  }
}

2. 与 VS Code 集成

与 VS Code 集成时，配置位于 .vscode/mcp.json：

{
  "mcpServers": {
    "mcp_vuln": {
      "command": "npm",
      "args": [
        "run",
        "dev",
        "mcp-vulnerability-scanner",
        "--prefix",
        "/path/to/mcp-vulnerability-scanner"
      ],
      "env": {
        "MCP_SERVER_PORT": "3000"
      }
    }
  }
}

更新 --prefix 路径，使其指向你的安装位置。

使用示例

以下示例展示了漏洞扫描器的运行情况：

• 扫描单个 Ip 地址

• 扫描多个 Ip 地址

可用工具

此 MCP 服务提供以下工具：

1. scan-ip

扫描单个 IP 地址的漏洞。

参数：

• ip：要扫描的 IP 地址（字符串）

使用示例：

scan-ip 192.168.1.1

2. scan-multiple-ips

扫描多个 IP 地址的漏洞。

参数：

• ips：要扫描的 IP 地址数组（string[]）

使用示例：

scan-multiple-ips ["192.168.1.1", "192.168.1.2", "192.168.1.3"]

部署选项

1. 本地开发

在开发模式下运行服务：

npm run dev

2. 构建并在生产环境中运行

npm run build
npm start

3. Docker 部署

在项目根目录中创建 Dockerfile：

FROM node:18-alpine

# Install Nmap
RUN apk add --no-cache nmap

WORKDIR /app

COPY package*.json ./
RUN npm ci

COPY . .
RUN npm run build

EXPOSE 3000

CMD ["npm", "start"]

构建并运行 Docker 容器：

docker build -t mcp-vulnerability-scanner .
docker run -p 3000:3000 mcp-vulnerability-scanner

4. VS Code 扩展集成

若要在 VS Code 中使用此服务：

1. 按照上文所示配置 .vscode/mcp.json 文件
2. 确保正确设置服务路径
3. MCP 扩展即可使用此服务

安全注意事项

• 运行全面的 Nmap 扫描需要管理员/root 权限
• 仅扫描你有权扫描的 IP 地址
• 请注意，漏洞扫描可能会触发安全系统或 IDS 警报
• 扫描结果仅供参考

许可证

MIT