AI Assistant Chat with Nmap Tool Integration MCP Server

@jarrodcoulter

代码仓库

基本信息

分类

AI 与智能体

许可证

MIT license

传输方式

stdio

作者

jarrodcoulter

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

AI Assistant Chat with Nmap Tool Integration MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

常见问题

What are the prerequisites?

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

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.

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 .`.

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).

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`.

AI 与智能体分类下的更多 MCP 服务器

Gemina

Gemina Tech Ltd.

Extract, search and tag any document — invoices, receipts, contracts, forms, or your own templates. 13 tools, one sign-in (OAuth 2.1) or API key, free FileTag tier, data residency in the EU, US, Israel or Asia.

AON — Agent Offer Network

AON

AON MCP connects AI agents to real, buyable products and services with live pricing and tracked links—enabling builders to earn developer revenue share from attributed clicks and conversions.

XDC AI

XDC AI is a remote MCP server available at https://xdcai.tech.

UnificAlly MCP

unifically-dev

UnificAlly MCP server. One API for 100+ AI video, image, music and speech models. https://mcp.unifically.com/mcp

Tokenaissance

Rain

Tokenaissance is a online Personal Agent for Quant and Research investment available at https://tokenaissance.com.