Advertise
MCP.so
Sign In

AI Assistant Chat with Nmap Tool Integration MCP Server

@jarrodcoulter

Repository

Basic information

Category

AI & Agents

License

MIT license

Transports

stdio

Author

jarrodcoulter

About AI Assistant Chat with Nmap Tool Integration MCP Server

An example MCP server with a couple nmap scans as tools.

#nmap#ai#assistant#network-scanning

AI Assistant Chat with Nmap Tool Integration MCP Server config

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

{
  "mcpServers": {
    "nmap-mcp-server-jarrodcoulter": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "nmap-mcp-server",
        "."
      ]
    }
  }
}

AI Assistant Chat with Nmap Tool Integration MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is AI Assistant Chat with Nmap Tool Integration?

This project provides a web-based chat interface using Gradio where users interact with an AI assistant powered by the OpenAI API. The assistant is equipped with tools to interact with the local filesystem and perform network scans using a containerized Nmap server. It is built on the OpenAI Agents SDK and uses Model Context Protocol (MCP) servers for tool integration.

How to use AI Assistant Chat with Nmap Tool Integration?

After cloning the repository, set the OPENAI_API_KEY environment variable, build the Nmap Docker image with docker build -t nmap-mcp-server ., install Python dependencies from requirements.txt, and run python app.py. Ensure Docker is running and a virtual environment is activated.

Key features of AI Assistant Chat with Nmap Tool Integration

  • Conversational AI assistant powered by OpenAI.
  • Filesystem access tool scoped to the application directory.
  • Nmap scanning tools: ping_host, scan_network, all_scan_network, all_ports_scan_network, smb_share_enum_scan.
  • Web-based UI using Gradio.
  • Containerized Nmap server via Docker for isolation.

Use cases of AI Assistant Chat with Nmap Tool Integration

  • Perform network ping tests through natural language requests.
  • Scan top 100 ports on a target host or network.
  • Run comprehensive network scans with service detection.
  • Enumerate SMB shares on discovered hosts.
  • Read or write local files within the application directory via chat.

Frequently asked questions

1

What are the prerequisites?

Python 3.9+, Docker (latest), Node.js/npm (for the filesystem MCP server), and an OpenAI API key are required.

2

How do I set the OpenAI API key?

Export it as the environment variable `OPENAI_API_KEY`. Commands are provided in the README for Linux/macOS, Windows Command Prompt, and PowerShell.

3

Does the Nmap server require Docker?

Yes, the Nmap toolkit server runs inside a Docker container built from the provided `Dockerfile` using `docker build -t nmap-mcp-server .`.

4

What specific Nmap scans are available?

Five tools: `ping_host`, `scan_network` (top 100 ports), `all_scan_network` (comprehensive -A scan), `all_ports_scan_network` (all 65535 ports), and `smb_share_enum_scan` (SMB share enumeration).

5

How do I run the application?

Ensure your API key is set, Docker is running, and you are in the project root with the virtual environment activated, then execute `python app.py`.

Comments

More AI & Agents MCP servers

FLORA

FLORA is a remote MCP server available at https://agents.flora.ai. The FLORA MCP lets users generate, organize, and iterate on visual assets — hero images, moodboards, lifestyle shots, promo graphics — directly from a co

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

Fotor MCP

fotor

Bring ideas to life with Fotor MCP: generate and edit images, enhance product photos, and create videos, voiceovers, and music.

localscreenshot - website screenshot mcp for ai agents

localscreenshot is a Website screenshot MCP server and API available at https://localscreenshot.com/api. Localscreenshot screenshot api turns any public web page into an image or a PDF. Take the capture from one of 227 c

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14
Advertise