Skip to main content
Glama
Raiaan-GB

nmap-mcp-server

by Raiaan-GB
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

agenticAI — MCP Tool Servers

A pair of Model Context Protocol (MCP) servers that expose useful tools to LLM agents (e.g. Claude, or any MCP-compatible client) over stdio, built with the official Python mcp[cli] SDK and FastMCP.

Servers

nmap-server.py — Network scanning tools

Wraps the nmap CLI as a set of async MCP tools, letting an agent run network scans, parse the XML output, and get back structured JSON. Includes target validation (IP / CIDR / hostname regex) before any command is executed, and a 10-minute timeout on every scan.

Exposed tools:

Tool

Purpose

nmap_ping_sweep

Discover live hosts on a network

nmap_tcp_scan

TCP connect/SYN scan over a port range

nmap_udp_scan

UDP scan of common service ports

nmap_service_scan

Service/version detection

nmap_os_detection

OS fingerprinting

nmap_aggressive_scan

Combined OS/version/script/traceroute scan

nmap_vuln_scan

NSE vulnerability scripts

nmap_script_scan

Run a specific NSE script

nmap_default_scripts

Run nmap's default NSE script set

nmap_stealth_scan

SYN stealth scan

nmap_timing_scan

Scan with a chosen timing template (T0–T5)

nmap_top_ports

Scan the N most common ports

nmap_custom_scan

Pass arbitrary nmap flags

Results are parsed from nmap's XML output into structured summaries (open ports, services, host state, etc.) rather than raw text.

todo-mcp.py — Minimal task-list demo server

A small reference server (four tools: count_tasks, show_tasks, add_task, search_tasks) used to demonstrate the basic MCP tool pattern before building the more complex nmap server.

Related MCP server: Nmap MCP Server

Setup

Requires Python 3.11+ and uv.

uv sync

Run a server directly:

uv run nmap-server.py
uv run todo-mcp.py

Or point an MCP-compatible client (Claude Desktop, etc.) at either script as a stdio server.

Note: nmap-server.py shells out to a locally installed nmap binary — only run scans against hosts/networks you're authorised to test.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Nmap MCP Server

    mohdhaji87
    F
    license
    B
    quality
    D
    maintenance
    Exposes Nmap network scanning capabilities through a Model Context Protocol (MCP) server, allowing users to perform various types of network scans including vulnerability assessment, service detection, and OS fingerprinting.
    11
    6
    -

  • Nmap MCP Server

    flagify-com
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables network security scanning using Nmap through MCP protocol. Supports quick port scans, full port scans with service detection, and custom Nmap commands with async task management.
    3
    MIT

  • nmap-mcp

    Vorota-ai
    A
    license
    A
    quality
    D
    maintenance
    A production-ready MCP server that wraps Nmap to enable AI agents to perform automated network security assessments, including port scanning, host discovery, service detection, OS fingerprinting, and vulnerability scanning.
    6
    16
    Apache 2.0