https://github.com/happyhackingspace/mcp-zmap
A FastMCP wrapper for ZMap, enabling subnet and port scans through natural language prompts in Claude Desktop using Model Context Protocol (MCP).
https://github.com/happyhackingspace/mcp-zmap
mcp-server zmap
Last synced: 7 months ago
JSON representation
A FastMCP wrapper for ZMap, enabling subnet and port scans through natural language prompts in Claude Desktop using Model Context Protocol (MCP).
- Host: GitHub
- URL: https://github.com/happyhackingspace/mcp-zmap
- Owner: HappyHackingSpace
- License: mit
- Created: 2025-04-16T17:43:09.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-16T17:57:10.000Z (11 months ago)
- Last Synced: 2025-05-07T18:43:48.323Z (10 months ago)
- Topics: mcp-server, zmap
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ZMap MCP
A FastMCP wrapper for ZMap, enabling subnet and port scans through natural language prompts in Claude Desktop using Model Context Protocol (MCP).
## Install
```
> sudo apt install zmap -y
> uv venv
> uv add "mcp[cli]" httpx
> pip install zmapsdk
> pip install FastMCP
> pip install ipaddress
```
## Requirements
- Python 3.13+
- ZMap network scanner (installed locally or via Docker)
- FastMCP
- zmapsdk
## Usage
### Running the Server
Start the FastMCP server:
```
fastmcp install server.py
python server.py
Run Claude desktop
```
### Available Tools
The server exposes the following tools:
- `scan(target, port)`: Scan a specific subnet for open ports
- `target`: Target subnet in CIDR notation (e.g., "192.168.1.0/24")
- `port`: Target port number to scan
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Disclaimer
This project is intended for educational and authorized security testing purposes only. Unauthorized scanning of networks that you do not own or have explicit permission to test is strictly prohibited and may be illegal in your jurisdiction.
By using this software, you agree that you are solely responsible for your actions. The authors and contributors of this project assume no liability for any misuse or damage caused by the use of this tool.