MCP 漏洞扫描器

一个 Model Context Protocol (MCP) 服务器，用于扫描 IP 地址的漏洞。该服务器提供工具来对单个 IP 或多个 IP 进行安全扫描。

功能

• 使用多种方法扫描 IP 地址中的漏洞：
  • Nmap 漏洞扫描
  • 基于 API 的漏洞检查
• 支持单个 IP 扫描或批量扫描多个 IP
• 返回详细的报告，包括漏洞的严重性、描述和修复步骤
• 实现 Model Context Protocol，便于与 MCP 客户端集成

先决条件

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

安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   

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

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

配置

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

1. .mcp.json

这是主要的 MCP 配置文件：

{
  "name": "vulnerability-scanner",
  "version": "1.0.0",
  "description": "一个用于在 IP 地址上扫描漏洞的 MCP 服务器",
  "command": "npm",
  "args": ["run", "dev"],
  "capabilities": {
    "contextItemTypes": ["ip"]
  }
}

2. 与 VS Code 集成

在 .vscode/mcp.json 中配置 VS Code：

{
  "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 服务器提供以下工具：

扫描器

# 安装扫描器
npm install mcp-vulnerability-scanner --save

示例代码

const { scan } = require('mcp-vulnerability-scanner');

// 执行扫描
scan(targetIP, (result) => {
  console.log(result);
});

部署选项

安装到现有项目

要将 MCP 漏洞扫描器集成到现有项目，请按照以下步骤操作：

1. 将 mcp-vulnerability-scanner 添加到项目的依赖项中：

   "dependencies": {
     "mcp-vulnerability-scanner": "^1.0.0"
   }
   

2. 在代码中使用扫描器：

   const { scan } = require('mcp-vulnerability-scanner');
   
   // 执行扫描
   scan(targetIP, (result) => {
     console.log(result);
   });
   

安全注意事项

• 确保所有 API 请求都经过身份验证和授权。
• 定期更新漏洞数据库以获取最新的安全信息。
• 避免在生产环境中公开暴露扫描功能。

通过以上步骤，您可以轻松地将 MCP 漏洞扫描器集成到您的项目中，并提升您的网络安全能力。