Nmap MCP Server

🚀 Nmap MCP Server

Model Context Protocol (MCP)サーバーです。FastMCPを使用し、標準入出力トランスポートを通じてNmapのコマンドライン機能をMCPツールとして公開します。このサーバーは、Nmapコマンドラインツールを通じて包括的なネットワークスキャン機能を提供します。

🚀 FastMCPの実装

このサーバーは、FastMCPという最新の高性能MCPフレームワークを使用して構築されています。以下の機能を提供します。

• シンプルなAPI：デコレータベースのクリーンなツール登録
• 型安全性：完全な型ヒントとバリデーション
• 標準入出力トランスポート：標準入出力を介した効率的な通信
• 非同期サポート：適切なエラーハンドリングを備えた非ブロッキング操作

✨ 主な機能

Nmap MCPサーバーは、FastMCPのデコレータを使用して以下のツールを公開しています。

1. 基本スキャン (nmap_basic_scan)

異なる強度レベルで基本的なNmapスキャンを実行します。

• クイック：高スループットの高速スキャン
• 包括的：サービス検出とOS検出を含む完全なスキャン
• ステルス：検出を回避するための低プロファイルなスキャン

2. サービス検出 (nmap_service_detection)

設定可能な強度レベル（0 - 9）で、ターゲットホストで実行されているサービスとバージョンを検出します。

3. OS検出 (nmap_os_detection)

設定可能なリトライ回数で、ターゲットホストで実行されているオペレーティングシステムを検出します。

4. スクリプトスキャン (nmap_script_scan)

高度な調査と脆弱性評価のために、NSE（Nmap Scripting Engine）スクリプトを実行します。

5. ステルススキャン (nmap_stealth_scan)

設定可能なタイミングテンプレートを使用して、検出を最小限に抑えたSYNスキャンを実行します。

6. 包括的スキャン (nmap_comprehensive_scan)

複数の検出方法を組み合わせた全機能スキャンを実行します。

7. ピングスキャン (nmap_ping_scan)

さまざまなピング方法（ICMP、TCP、または両方）を使用して、アクティブなホストを発見します。

8. ポートスキャン (nmap_port_scan)

異なる方法（SYN、Connect、UDP）を使用して、特定のポートをスキャンします。

9. 脆弱性スキャン (nmap_vulnerability_scan)

異なるカテゴリの脆弱性検出スクリプトを実行します。

10. ネットワーク発見 (nmap_network_discovery)

ネットワーク全体のホストとサービスを発見します。

11. カスタムスキャン (nmap_custom_scan)

最大限の柔軟性のために、ユーザー定義のNmapオプションでスキャンを実行します。

📦 インストール

前提条件

• Python 3.10以上
• Nmapがインストールされ、システムのPATHに含まれていること

Nmapのインストール

macOS:

brew install nmap

Ubuntu/Debian:

sudo apt update
sudo apt install nmap

CentOS/RHEL:

sudo yum install nmap
# または新しいバージョンの場合:
sudo dnf install nmap

Windows: nmap.orgからダウンロードしてインストールしてください。

このリポジトリのインストール

1. このリポジトリをクローンします。

git clone <repository-url>
cd nmap-mcp-server

2. 依存関係をインストールします。

pip install -e .

💻 使用例

FastMCPサーバーの起動

サーバーは、標準入出力トランスポートで直接起動することができます。

python server.py

または、インストールされたスクリプトを使用して起動することもできます。

nmap-mcp-server

Claude Desktopの設定

Claude DesktopのMCP設定に以下の設定を追加します。

{
  "mcpServers": {
    "NmapMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/haji/mcp-servers/nmap-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

設定手順:

1. Claude Desktopを開きます。
2. 設定 → MCPサーバーに移動します。
3. 上記のJSON設定を追加します。
4. Claude Desktopを再起動します。
5. サーバーが接続されていることを確認します。

基本的な使用法

基本的なネットワークスキャン

# ツールは型付きパラメータで呼び出されます
result = await nmap_basic_scan(
    targets="192.168.1.0/24",
    ports="common",
    scan_type="quick"
)

サービス検出

result = await nmap_service_detection(
    targets="example.com",
    ports="80,443,8080",
    intensity=7
)

脆弱性評価

result = await nmap_vulnerability_scan(
    targets="192.168.1.100",
    ports="common",
    vuln_category="all"
)

カスタムスキャン

result = await nmap_custom_scan(
    targets="example.com",
    custom_options="-sS -p 1-1000 -A --script=vuln",
    output_format="normal"
)

🔧 技術詳細

FastMCPアーキテクチャ

サーバーはFastMCPのクリーンなデコレータパターンを使用しています。

@app.tool(
    name="nmap_basic_scan",
    description="Perform a basic Nmap scan of specified targets"
)
async def nmap_basic_scan(
    targets: str,
    ports: str = "common",
    scan_type: str = "quick"
) -> str:
    """Perform a basic Nmap scan of specified targets."""
    # ここに実装を記述します
    return result

セキュリティに関する考慮事項

⚠️ 重要なセキュリティ注意事項

1. 法的な遵守：所有している、または明示的な許可を得たネットワークとシステムのみをスキャンしてください。
2. ネットワークへの影響：一部のスキャンはリソースを大量に消費し、ネットワーク性能に影響を与える可能性があります。
3. 検出：攻撃的なスキャンは、セキュリティシステムやファイアウォールをトリガーする可能性があります。
4. レート制限：サーバーにはタイムアウトとレート制限が組み込まれており、悪用を防止しています。

エラーハンドリング

FastMCPサーバーは、以下のエラーに対する包括的なエラーハンドリングを備えています。

• Nmapコマンドが見つからない場合
• コマンドのタイムアウト
• 無効な引数
• ネットワーク接続問題
• 権限エラー

ロギング

サーバーはPythonの組み込みロギングシステムを使用しています。ログには以下が含まれます。

• コマンド実行の詳細
• エラーメッセージ
• パフォーマンスメトリクス

テスト

FastMCPサーバーをテストします。

# ツールの登録と機能をテストします
python test_fastmcp.py

# サンプルをテストします
python example_usage.py

🤝 コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

📢 免責事項

このツールは、教育および許可されたセキュリティテスト目的のみに使用されることを意図しています。ユーザーは、ネットワークまたはシステムをスキャンする前に適切な許可を得ていることを確認する責任があります。

🆘 サポート

問題や質問がある場合は、以下の手順を実行してください。

1. エラーログを確認します。
2. Nmapがインストールされ、アクセス可能であることを確認します。
3. 適切な権限を持っていることを確認します。
4. リポジトリに問題を登録します。

📜 変更履歴

バージョン1.0.0

• FastMCPの実装を含む最初のリリース
• すべての主要なNmapスキャン手法のサポート
• 包括的なエラーハンドリング
• 標準入出力トランスポートモード
• 型安全なツール定義
• uvを使用したClaude Desktopの設定