1. Conduid
  2. Developer Tools
  3. mcp-server-nmap
MCP server · Developer Tools

mcp-server-nmap

by · github.com/daedalus/mcp-server-nmap

Nmap NSE script for discovering Model Context Protocol (MCP) endpoints via HTTP, SSE, and WebSocket — supports server fingerprinting, tool/resource enumeration, and optional auth brute force.

Unclaimed last commit 6 months ago devtools
InstallView source
37Low

Scored 16 days ago · breakdown

About mcp-server-nmap

mcp-server-nmap is an MCP server published by daedalus in the Developer Tools category: nmap NSE script for discovering Model Context Protocol (MCP) endpoints via HTTP, SSE, and WebSocket — supports server fingerprinting, tool/resource enumeration, and optional auth brute force.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

uvx
uvx mcp-server-nmap
pip
pip install mcp-server-nmap

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (3)

port_scanner_async_initInitialize async PortScannerAsync

Parameters not published.

port_scanner_initInitialize synchronous PortScanner

Parameters not published.

port_scanner_yield_initInitialize generator-based PortScannerYield

Parameters not published.

Ask AI

✦

Ask AI about mcp-server-nmap

Powered by Claude · Grounded in docs

I know everything about mcp-server-nmap. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

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/

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About mcp-server-nmap

How do I install mcp-server-nmap?

Run uvx mcp-server-nmap, then add the server to your MCP client's configuration.

Is mcp-server-nmap safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is mcp-server-nmap still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.