Integrates the Nmap network scanning tool with MCP, enabling network scanning capabilities within MCP-compatible environments.
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 via Smithery:
npx -y @smithery/cli install @0xPratikPatil/nmapmcp --client claude
Clone the Repository:
git clone https://github.com/0xPratikPatil/NmapMCP.git
cd NmapMCP
Install uv
:
curl -LsSf https://astral.sh/uv/install.sh | sh
Create environment:
uv venv
Install dependencies from pyproject.toml
uv pip install
or
uv pip install -r pyproject.toml
To configure the Nmap MCP Server, edit the claude_desktop_config.json
file located in the project root. This file allows you to set default scan arguments, define MCP tool behaviors, and adjust logging settings.
Example claude_desktop_config.json
:
{
"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.
Clone Your Fork:
git clone https://github.com/0xPratikPatil/NmapMCP.git
Create a New Branch:
git checkout -b feature/your-feature-name
Make Your Changes: Implement your feature or fix.
Run Tests: Ensure all tests pass.
Commit Changes:
git commit -m "Add feature: your feature name"
Push to Your Fork:
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.
Obtains latest dependency details for Clojure libraries.
A server for securely executing commands on the host system, requiring Java 21 or higher.
Execute developer-defined bash scripts in a Dockerized environment for coding agents.
An MCP server with built-in GitHub OAuth support, designed for deployment on Cloudflare Workers.
A framework for AI-powered command execution and a plugin-based tool system. It can be run as a standalone service or embedded in other projects to expose a consistent API for invoking tools and managing tasks.
Integrates with Language Server Protocol (LSP) to provide features like code completion, diagnostics, and hover information.
Provides sarcastic and cynical code reviews from the perspective of a grumpy senior developer.
Manage DevContainer environments using natural language prompts in any MCP-compatible editor.
An authentication-free, remote MCP server deployable on Cloudflare Workers or locally via npm.
Tools for Xcode project management, building, testing, archiving, code signing, and iOS development utilities.