{"id":27959331,"url":"https://github.com/happyhackingspace/mcp-zmap","last_synced_at":"2025-07-30T20:05:17.573Z","repository":{"id":288308752,"uuid":"967596954","full_name":"HappyHackingSpace/MCP-Zmap","owner":"HappyHackingSpace","description":"A FastMCP wrapper for ZMap, enabling subnet and port scans through natural language prompts in Claude Desktop using Model Context Protocol (MCP).","archived":false,"fork":false,"pushed_at":"2025-04-16T17:57:10.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T18:43:48.323Z","etag":null,"topics":["mcp-server","zmap"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HappyHackingSpace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-16T17:43:09.000Z","updated_at":"2025-04-16T18:17:40.000Z","dependencies_parsed_at":"2025-04-21T23:46:08.418Z","dependency_job_id":null,"html_url":"https://github.com/HappyHackingSpace/MCP-Zmap","commit_stats":null,"previous_names":["happyhackingspace/zmapmcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HappyHackingSpace/MCP-Zmap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HappyHackingSpace%2FMCP-Zmap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HappyHackingSpace%2FMCP-Zmap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HappyHackingSpace%2FMCP-Zmap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HappyHackingSpace%2FMCP-Zmap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HappyHackingSpace","download_url":"https://codeload.github.com/HappyHackingSpace/MCP-Zmap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HappyHackingSpace%2FMCP-Zmap/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267930660,"owners_count":24167481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp-server","zmap"],"created_at":"2025-05-07T18:29:40.001Z","updated_at":"2025-07-30T20:05:17.491Z","avatar_url":"https://github.com/HappyHackingSpace.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZMap MCP \r\n\r\nA FastMCP wrapper for ZMap, enabling subnet and port scans through natural language prompts in Claude Desktop using Model Context Protocol (MCP).\r\n\r\n## Install\r\n```\r\n\u003e sudo apt install zmap -y\r\n\u003e uv venv\r\n\u003e uv add \"mcp[cli]\" httpx\r\n\u003e pip install zmapsdk\r\n\u003e pip install FastMCP\r\n\u003e pip install ipaddress\r\n```\r\n\r\n## Requirements\r\n\r\n- Python 3.13+\r\n- ZMap network scanner (installed locally or via Docker)\r\n- FastMCP\r\n- zmapsdk\r\n\r\n## Usage\r\n\r\n### Running the Server\r\n\r\nStart the FastMCP server:\r\n\r\n```\r\nfastmcp install server.py\r\npython server.py\r\nRun Claude desktop\r\n```\r\n\r\n### Available Tools\r\n\r\nThe server exposes the following tools:\r\n\r\n- `scan(target, port)`: Scan a specific subnet for open ports\r\n  - `target`: Target subnet in CIDR notation (e.g., \"192.168.1.0/24\")\r\n  - `port`: Target port number to scan\r\n\r\n\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## Disclaimer\r\nThis 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.\r\n\r\nBy 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.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhappyhackingspace%2Fmcp-zmap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhappyhackingspace%2Fmcp-zmap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhappyhackingspace%2Fmcp-zmap/lists"}