MCP.so
Sign In

Nmap MCP Server

@imjdl

Repository

About Nmap MCP Server

This is a Model Control Protocol (MCP) server that provides access to nmap network scanning functionality.

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

imjdl

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nmap-mcpserver": {
      "command": "python",
      "args": [
        "-m",
        "src.nmap_mcp"
      ]
    }
  }
}

Tools

2

`target`: Target host or network (e.g., 192.168.1.1 or 192.168.1.0/24)

`scan_id`: ID of the scan to retrieve

Overview

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.

Comments

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K