Skip to main content
Glama
daedalus

mcp-server-nmap

by daedalus
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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/

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Nmap MCP Server

    mohdhaji87
    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.
    Last updated
    11
    5

  • Nmap MCP Server

    sideffect263
    F
    license
    -
    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.
    Last updated

  • Nmap MCP Server

    flagify-com
    A
    license
    -
    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.
    Last updated
    3
    MIT

  • nmap-mcp

    Vorota-ai
    A
    license
    A
    quality
    F
    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.
    Last updated
    6
    13
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • mcp-server

    MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.

  • MCP Fortress

    Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.

  • Shodan Internetdb

    Shodan InternetDB MCP — wraps Shodan InternetDB (internetdb.shodan.io)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/daedalus/mcp-server-nmap'

If you have feedback or need assistance with the MCP directory API, please join our Discord server