Nmap MCP Server

What is Nmap MCP Server?

It is a Model Context Protocol (MCP) server that provides access to nmap network scanning functionality, allowing AI models to run scans, retrieve results, and analyze them via prompts.

How to use Nmap MCP Server?

Install Python 3.10+, python‑libnmap, and system‑installed nmap. Run the server with python -m src.nmap_mcp or install the package with pip install -e . and use the nmap-mcp command. A Docker image is also provided for containerized use.

Key features of Nmap MCP Server?

• Run nmap scans with custom target and options
• Store and retrieve scan results
• Analyze scan results using AI prompts
• Access scans via nmap://scan/{scan_id} resource URIs
• List all saved scan results with no parameters
• Docker support for easy deployment

Use cases of Nmap MCP Server?

• Scan a local network to discover live hosts and open ports
• Perform service version detection on specific ports using -sV
• Analyze a scan result with a security‑focused AI prompt
• Retrieve details of a previous scan by its ID
• List all historical scans for auditing or reporting

FAQ from Nmap MCP Server

What dependencies are required?

Python 3.10+ and the python-libnmap package, plus nmap installed on the system (e.g., sudo apt-get install nmap).

How do I run the server?

Directly with python -m src.nmap_mcp from the source directory, or install the package and run the nmap-mcp command. A Docker container can also be built and run.

What security considerations exist?

The server executes nmap commands on your system. Unauthorized scanning may be illegal in some jurisdictions; always scan only networks you own or have permission to scan.

What if nmap is not found or fails?

Ensure nmap is installed and available in your PATH. The server logs the nmap executable being used and will attempt to use the full path to avoid conflicts.

Is Docker usage supported?

Yes. Build the image with docker build -t nmap-mcp-server . and run with docker run -it --rm nmap-mcp-server. This simplifies deployment without worrying about installation dependencies.