Mcp Port Scan

Name: Mcp Port Scan
Author: relaxcloud-cn

@relaxcloud-cn

Repository

About Mcp Port Scan

MCP Port Scanner 是一款专为 AI 工具设计的智能端口扫描服务。它通过 MCP 协议与 Cursor 等 AI 编辑器无缝集成，将强大的网络扫描能力直接带入您的开发工作流。

Basic information

Config

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

{
  "mcpServers": {
    "port-scanner": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-port-scanner",
        "python",
        "-m",
        "mcp_port_scanner.interfaces.mcp_local_server"
      ],
      "description": "智能端口扫描器 - stdio连接"
    }
  }
}

Tools

No tools detected

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

Overview

What is Mcp Port Scan?

Mcp Port Scan is an intelligent port scanning service built on the MCP (Model Context Protocol), designed specifically for AI assistants. It integrates with Cursor and uses RustScan under the hood to provide fast, natural-language-driven port scanning capabilities.

How to use Mcp Port Scan?

Install dependencies with pip install -r requirements.txt, then configure the MCP client (e.g., Cursor) by adding a JSON entry for the server — either using Docker (recommended) or a local Python process. After setup, interact with the AI assistant using natural language commands like “scan 192.168.1.1’s ports”.

Key features of Mcp Port Scan

Provides five scanning tools: scan_target, batch_scan, get_scan_status, list_active_scans, get_scan_result
Supports scanning single or multiple targets
Allows specifying custom port lists (e.g., 80,443,8080)
Can run via Docker container or local Python
Integrates directly with Cursor’s MCP configuration

Use cases of Mcp Port Scan

Quick port scanning of a single IP or domain via AI chat
Batch scanning multiple targets in one request
Monitoring active or completed scan tasks and retrieving results

FAQ from Mcp Port Scan

What is the purpose of this server?

It enables AI assistants (like those in Cursor) to perform port scans using natural language, abstracting away the command-line interface of RustScan.

How do I configure the server in Cursor?

Add a JSON configuration block under mcpServers in your Cursor MCP settings, either pointing to a Docker container or a local Python module (mcp_port_scanner.interfaces.mcp_local_server).

What dependencies are required?

Python packages (listed in requirements.txt) and the RustScan binary (available in the bin/ directory for Windows, Linux, and macOS).

Can I run it without Docker?

Yes. Use the local Python configuration method, set PYTHONPATH to src, and run the MCP local server module directly.

What scanning commands does the AI understand?

Commands like “scan ”, “scan ’s ports 80,443”, “batch scan ,”, and “view current scan status” are supported.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K