MCP Vulnerability Scanner

MCP 脆弱性スキャナー

IP アドレスの脆弱性をスキャンする Model Context Protocol（MCP）サーバーです。このサーバーは、個別の IP または複数の IP を一度にセキュリティスキャンするツールを提供します。

特長

• 複数の方法で IP アドレスの脆弱性をスキャンします：
  • Nmap による脆弱性スキャン
  • API ベースの脆弱性チェック
• 単一 IP のスキャンと複数 IP の一括スキャンに対応します
• 脆弱性の深刻度、説明、修復手順を含む詳細なレポートを返します
• MCP クライアントと簡単に連携できるよう、Model Context Protocol を実装しています

前提条件

• 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 Vulnerability Scanner は、以下のファイルで設定します。

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