NMAP Scanner

🚀 MCP NMAP サーバー

Model Context Protocol (MCP) サーバーで、AIアシスタントがNMAPを使用してネットワークスキャン操作を実行できるようにします。このサーバーは、AIモデルに標準化されたインターフェースを提供し、NMAPとやり取りできるようにし、AI対話を通じたネットワーク分析とセキュリティ評価を実現します。

🚀 クイックスタート

このMCP NMAPサーバーを使用することで、AIアシスタントがNMAPを使ってネットワークスキャンを行えるようになります。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

サーバーはNMAPの核心機能にアクセスするためのシンプルなインターフェースを提供します。高速スキャン、完全なポートスキャン、バージョン検出、およびカスタム時間テンプレートをサポートしています。この実装はNMAPのネイティブコマンドラインインターフェースを使用しており、信頼性と標準的なNMAP操作との一貫性を保証します。

📦 インストール

Smitheryを通じた自動インストール

Smitheryを通じてClaude Desktop用のNMAPサーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install mcp-nmap-server --client claude

手動インストール

npmを使用してグローバルにインストールするには、以下のコマンドを実行します。

npm install -g mcp-nmap-server

または、プロジェクト内にローカルインストールするには、以下のコマンドを実行します。

npm install mcp-nmap-server

📚 ドキュメント

前提条件

• Windows オペレーティングシステム
• Node.js（v18またはそれ以上のバージョン）
• NMAPがインストールされ、Windowsコマンドラインで使用可能
• TypeScriptを使用した開発

Claude Desktopとの設定

WindowsでこのサーバーをClaude Desktopと一緒に使用するには、Claudeの設定ファイルで設定する必要があります。設定ファイルは以下の場所にあります。 C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\config.json

mcpServersセクションにNMAPサーバーを追加することで設定します。以下はClaude Desktopの設定ファイルの完全な例です。

{
    "mcpServers": {
        "nmap": {
            "command": "node",
            "args": [
                "C:\\Users\\YOUR_USERNAME\\Downloads\\mcp-nmap-server\\dist\\index.js"
            ]
        }
    },
    "globalShortcut": "Ctrl+Q"
}

YOUR_USERNAMEをあなたのWindowsユーザー名に置き換え、NMAPサーバーのインストールパスを調整してください。

AIとの使用方法

設定が完了すると、AIアシスタント（Claudeなど）はrun_nmap_scan関数を呼び出すことでこのサーバーを使用できます。この関数は以下のパラメーターを受け取ります。

{
    target: string;            // スキャン対象のホストまたはネットワーク
    ports?: string;           // オプションのポート指定（例: "80,443" または "1-1000"）
    scanType?: 'quick' | 'full' | 'version';  // スキャンタイプ（デフォルト: 'quick'）
    timing?: number;          // NMAPの時間テンプレート 0-5（デフォルト: 3）
    additionalFlags?: string; // オプションの追加NMAPフラグ
}

Claudeとの対話例は以下の通りです。

人間：ローカルホスト上の開いているポートをスキャンしてくれますか？

Claude：NMAPを使用してローカルホストをスキャンします。

<localhostを対象とし、タイプがquick、時間が3に設定されたnmapスキャンを実行>

📄 ライセンス

MIT License

サポート

問題、提案、または貢献に関しては、GitHubリポジトリをご覧ください。