NmapMCP

by 0xpratikpatil

Not rated
GitHub

About

Integrates the Nmap network scanning tool with MCP, enabling network scanning capabilities within MCP-compatible environments.

Details

Author
0xpratikpatil
Categories
Developer Tools, Infrastructure, Security, Other

Setup

Install NmapMCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/0xpratikpatil/NmapMCP

Follow the installation instructions in the repository README, then restart your MCP client.

NmapMCP is a robust integration of the Nmap scanning tool with the Model Context Protocol (MCP), enabling seamless network scanning capabilities within MCP-compatible environments. This project allows users to perform various network scans, such as top ports scanning, DNS brute force, and more, directly through MCP interfaces.

-

Top Ports Scanning:Quickly identify the most commonly used ports on target hosts to assess potential entry points.

DNS Brute Force:Discover subdomains associated with a target domain, aiding in comprehensive domain mapping.

List Scan:Obtain a list of active hosts within a specified range without port scanning, useful for network inventory.

OS Detection:Determine the operating system of a target host by analyzing network responses, assisting in vulnerability assessment.

Version Detection:Identify service versions running on open ports to detect outdated or vulnerable services.

FIN Scan:Perform stealthy scans by sending FIN packets to detect open ports without establishing a full connection.

Idle Scan:Conduct highly stealthy scans by leveraging idle hosts to probe target systems, minimizing detection risks.

Ping Scan:Detect active hosts in a network by sending ICMP echo requests, useful for network mapping.

SYN Scan:Perform half-open TCP scans to identify open ports without completing the TCP handshake, reducing detection likelihood.

TCP Connect Scan:Establish full TCP connections to probe open ports, useful when SYN scans are not feasible.

UDP Scan:Identify open UDP ports on a target host to detect services that do not use TCP.

Port Scan Only:Focus solely on scanning ports without additional host discovery, streamlining the scanning process.

No Port Scan:Perform host discovery without scanning ports, useful for identifying live hosts without probing services.

ARP Discovery:Identify active devices within a local network segment using ARP requests, effective in LAN environments.

Disable DNS Resolution:Perform scans without resolving IP addresses to hostnames, enhancing scan speed and reducing DNS query traffic.

To install Nmap Integration for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @0xPratikPatil/nmapmcp --client claude
git clone https://github.com/0xPratikPatil/NmapMCP.git cd NmapMCP
curl -LsSf https://astral.sh/uv/install.sh | sh

Install dependencies frompyproject.toml

To configure the Nmap MCP Server, edit theclaude_desktop_config.jsonfile located in the project root. This file allows you to set default scan arguments, define MCP tool behaviors, and adjust logging settings.

{ "mcpServers": { "NmapMCP": { "command": "uv", "args": [ "--directory", "/path/to/NmapMCP", "run", "main.py" ] } } }

Contributions are welcome! To contribute:
-

Fork the Repository:Click the "Fork" button at the top right of the repository page.

git clone https://github.com/0xPratikPatil/NmapMCP.git
git checkout -b feature/your-feature-name

Make Your Changes:Implement your feature or fix.

git commit -m "Add feature: your feature name"
git push origin feature/your-feature-name

Submit a Pull Request:Navigate to the original repository and click "New Pull Request."

This project is licensed under the MIT License.

Special thanks to the Nmap and MCP communities for their invaluable tools and support.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

MCP access to cluster-wide L4 and L7 network traffic, packets, APIs, and complete payloads.

Network reconnaissance and security scanning with port scanning, DNS analysis, and vulnerability assessment

A server for real-time network packet monitoring and security analysis.

Perform network scanning and security auditing using the NMAP utility.

Security testing MCP server with 51 tools for penetration testing, network forensics, memory analysis, and vulnerability assessment.

A comprehensive MCP server for managing OPNsense firewalls, offering over 300 tools for configuration and monitoring.

Manage OPNsense firewalls using Infrastructure as Code (IaC) principles.

Enables natural language interaction with pfSense firewalls through GenAI applications.

Create secure tunnels to expose local servers to the internet using untun.

Empowers LLMs with real-time network traffic analysis using tshark. Requires Wireshark's tshark to be installed.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.