mcp-vulnerability-scanner

🚀 MCP 漏洞扫描器

MCP 漏洞扫描器是一个基于 Model Context Protocol (MCP) 的服务器，可用于扫描 IP 地址的漏洞。它提供了强大的工具，支持对单个 IP 或多个 IP 进行安全扫描，助力提升网络安全防护能力。

🚀 快速开始

MCP 漏洞扫描器能有效扫描 IP 地址中的漏洞，为网络安全保驾护航。下面为你介绍其使用的基本流程。

✨ 主要特性

• 多种扫描方法：运用 Nmap 漏洞扫描和基于 API 的漏洞检查等多种手段，全面扫描 IP 地址中的漏洞。
• 灵活扫描模式：支持单个 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 路径以指向您的安装位置。

部署选项

安装到现有项目

要将 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 请求都经过身份验证和授权。
• 定期更新漏洞数据库以获取最新的安全信息。
• 避免在生产环境中公开暴露扫描功能。

💻 使用示例

基础用法

以下是一个示例，展示漏洞扫描器的运行情况：

• 单个 IP 地址扫描
• 多个 IP 地址扫描

高级用法

可用工具

此 MCP 服务器提供以下工具：

扫描器

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

示例代码

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

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

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