Nmap Mcpserver

🚀 Nmap MCP サーバー

このサーバーは、モデル制御プロトコル (MCP) に基づいており、nmap のネットワークスキャン機能へのアクセスを提供します。

✨ 主な機能

• カスタマイズ可能なオプションで指定されたターゲットに対して nmap スキャンを実行する
• スキャン結果を保存し、取得する
• AI プロンプトを使用してスキャン結果を分析する

📦 インストール

必要条件：

• Python 3.10 以上
• python-libnmap
• システムに nmap がインストールされている

pip install python-libnmap

システムに nmap がインストールされていることを確認します：

# Debian/Ubuntu の場合
sudo apt-get install nmap

# Fedora/CentOS の場合
sudo dnf install nmap

💻 使用例

基本的な使用法

サーバーの起動

ソースコードから直接サーバーを起動する：

python -m src.nmap_mcp

パッケージをインストールした後、コマンドとして実行する：

pip install -e .
nmap-mcp

利用可能なツール

1. run-nmap-scan

   • 指定されたターゲットに対して nmap スキャンを実行します。
   • パラメータ：
     • target：ターゲットホストまたはネットワーク（例：192.168.1.1 または 192.168.1.0/24）
     • options：nmap オプション（例：-sV -p 1-1000）

2. get-scan-details

   • 特定のスキャンの詳細情報を取得します。
   • パラメータ：
     • scan_id：取得するスキャンの ID

3. list-all-scans

   • 利用可能なすべてのスキャン結果をリストします。
   • パラメータ：なし

利用可能なプロンプト

1. analyze-scan
   • nmap スキャン結果を分析します。
   • パラメータ：
     • scan_id：分析するスキャンの ID
     • focus：分析の焦点（セキュリティ/サービス/概要）

リソース

スキャン結果は、nmap://scan/{scan_id} URI スキームを持つリソースとして利用可能です。

高度な使用法

サンプルワークフロー

1. スキャンを実行する：

ツールの呼び出し：run-nmap-scan
パラメータ：{"target": "192.168.1.0/24", "options": "-sV -p 22,80,443"}

2. スキャンの詳細情報を取得する：

ツールの呼び出し：get-scan-details
パラメータ：{"scan_id": "<前のステップの scan_id>"}

3. すべてのスキャンをリストする：

ツールの呼び出し：list-all-scans

4. スキャン結果を分析する：

プロンプトの取得：analyze-scan
パラメータ：{"scan_id": "<scan_id>", "focus": "セキュリティ"}

📚 ドキュメント

セキュリティ上の注意事項

このサーバーは、システム上で nmap コマンドを実行します。所有権がない、または許可を得ていないネットワークをスキャンする際には注意してください。一部の法域では、許可なくスキャンすることが違法となる場合があります。

トラブルシューティング

nmap が見つからない、または実行エラーに関連するエラーが発生した場合：

1. nmap がインストールされており、PATH で利用可能であることを確認します。
2. ログを確認して、使用されている nmap 実行ファイルを確認します。
3. サーバーは、競合を避けるために nmap の完全パスを使用しようとします。

Docker の使用

MCP サーバーを Docker コンテナで実行することができます：

# Docker イメージをビルドする
docker build -t nmap-mcp-server .

# Docker コンテナを実行する
docker run -it --rm nmap-mcp-server

Glama MCP ディレクトリと統合することで、Docker コンテナを使用することで、他の人が依存関係のインストールを心配することなく、この MCP サーバーを簡単に利用できるようになります。

📄 ライセンス

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