Skip to main content
Glama

mcp-server-nmap

MCP server that exposes the python-nmap library as MCP tools for network scanning operations.

PyPI Python

What is this?

This MCP server wraps the python-nmap library, allowing AI assistants to perform network reconnaissance through MCP tools. It provides three scanning interfaces:

  1. PortScanner (synchronous) - Blocking scans that wait for completion

  2. PortScannerAsync (asynchronous) - Non-blocking scans with callbacks

  3. PortScannerYield (generator) - Streaming results as hosts are discovered

Related MCP server: Nmap MCP Server

Prerequisites

  • nmap must be installed on the system

  • Python 3.10+

Install

pip install mcp-server-nmap

mcp-name: io.github.daedalus/mcp-server-nmap

MCP Server Registration

Add this to your MCP settings file:

{
  "mcpServers": {
    "mcp-server-nmap": {
      "command": "mcp-server-nmap"
    }
  }
}

Or with custom nmap path:

{
  "mcpServers": {
    "mcp-server-nmap": {
      "command": "mcp-server-nmap",
      "env": {
        "PATH": "/custom/path:$PATH"
      }
    }
  }
}

Available Tools

Initialization

Tool

Description

port_scanner_init

Initialize synchronous PortScanner

port_scanner_async_init

Initialize async PortScannerAsync

port_scanner_yield_init

Initialize generator-based PortScannerYield

Scanning

Tool

Description

port_scanner_scan

Scan hosts with nmap (synchronous)

port_scanner_async_scan

Scan hosts (async, non-blocking)

port_scanner_yield_scan

Scan with streaming results

port_scanner_listscan

List hosts without scanning

Results & State

Tool

Description

port_scanner_all_hosts

Get all scanned hosts

port_scanner_has_host

Check if host was scanned

port_scanner_get_item

Get detailed host scan data

port_scanner_scaninfo

Get scan configuration info

port_scanner_scanstats

Get scan statistics

port_scanner_command_line

Get nmap command used

port_scanner_csv

Get CSV output

port_scanner_last_output

Get raw nmap text output

Async Control

Tool

Description

port_scanner_async_still_scanning

Check if scan in progress

port_scanner_async_stop

Stop running scan

port_scanner_async_wait

Wait for scan to complete

XML Parsing

Tool

Description

port_scanner_analyse_xml

Parse existing nmap XML output

Common Scan Workflows

Basic port scan

# Initialize scanner
port_scanner_init()

# Scan target
port_scanner_scan(hosts="192.168.1.1", ports="22,80,443", arguments="-sV")

# Get results
port_scanner_get_item(host="192.168.1.1")

Service version detection

port_scanner_scan(hosts="scanme.nmap.org", arguments="-sV -sC")

Scan multiple hosts

port_scanner_scan(hosts="192.168.1.1-254", arguments="-sS -p 22")
port_scanner_all_hosts()

Network sweep

port_scanner_scan(hosts="192.168.1.0/24", arguments="-sn")
port_scanner_csv()  # Export to CSV

nmap Arguments Reference

Argument

Description

-sn

Ping scan (host discovery)

-sS

TCP SYN scan

-sT

TCP connect scan

-sU

UDP scan

-sV

Service version detection

-sC

Default scripts

-O

OS detection

-p

Port range

-oA

Output all formats

Development

git clone https://github.com/daedalus/mcp-server-nmap.git
cd mcp-server-nmap
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Exposes Nmap network scanning capabilities through a Model Context Protocol (MCP) server, allowing users to perform various types of network scans including vulnerability assessment, service detection, and OS fingerprinting.
    11
    6
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables network scanning and security assessment using Nmap through MCP, allowing AI assistants to perform port scans, service detection, and network reconnaissance on specified targets with configurable scan parameters.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables network security scanning using Nmap through MCP protocol. Supports quick port scans, full port scans with service detection, and custom Nmap commands with async task management.
    3
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    A production-ready MCP server that wraps Nmap to enable AI agents to perform automated network security assessments, including port scanning, host discovery, service detection, OS fingerprinting, and vulnerability scanning.
    6
    16
    Apache 2.0