MCPcopy Index your code
hub / github.com/ReddyyZ/astsu

github.com/ReddyyZ/astsu @v1.1.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.3 ↗ · + Follow
13 symbols 52 edges 5 files 1 documented · 8%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

astsu

Demonstration Video

How it works

  • Scan common ports

    Send a TCP Syn packet to the destination on the defined port, if the port is open, use an nmap scan to check the service running on the port and prints all the ports found.

  • Discover hosts in network

    Uses as a base the router's ip to map all possible ips. It then sends an ICMP packet to each IP, and waits for a response, if it receives any response saved in an array the IP of the online host, and when it finishes checking all hosts, prints all hosts online.

  • OS Scan

    Sends an ICMP packet to the destination and waits for a response. Then, extracts the TTL from the destination response and checks the possible OS in a list, if have founded, prints it.

OS Support

  • Windows :heavy_check_mark:
  • Linux :heavy_check_mark:
  • Mac :question:

How to install

Clone this repository git clone https://github.com/ReddyyZ/astsu.git
- Install python 3. - Linux - apt-get install python3 - chmod +x * - python3 -m pip install -r requirements.txt - python3 install.py - Done! - Windows - Python 3, download and install - python3 -m pip install -r requirements.txt - python3 install.py - Done!

Arguments

  • -sC | Scan common ports
  • -p | Protocol to use in the scan
  • -i | Interface to use
  • -t | Timeout to each request
  • -st | Use stealth scan method (TCP)
  • -sA | Scan all ports
  • -p | Protocol to use in the scan
  • -i | Interface to use
  • -t | Timeout to each request
  • -st | Use stealth scan method (TCP)
  • -sP | Scan a range ports
  • -p | Protocol to use in the scan
  • -i | Interface to use
  • -t | Timeout to each request
  • -st | Use stealth scan method (TCP)
  • -sO | Scan OS of a target
  • -d | Discover hosts in the network
  • -p | Protocol to use in the scan
  • -i | Interface to use

Examples

  • Discover hosts
astsu -d
  • Scan common ports using SYN Scan
astsu -sC -st 192.168.1.1
  • Scan a range of ports
astsu 192.168.1.1 -sP 1 443
  • Scan OS
astsu -sO 192.168.1.1

License

This project is under the MIT License.

Core symbols most depended-on inside this repo

port_scan
called by 3
astsu.py
handle_port_response
called by 3
astsu.py
range_scan
called by 3
astsu.py
print_figlet
called by 1
astsu.py
common_scan
called by 1
astsu.py
os_scan
called by 1
astsu.py
discover_net
called by 1
astsu.py
arguments
called by 1
astsu.py

Shape

Method 8
Function 4
Class 1

Languages

Python100%

Modules by API surface

astsu.py11 symbols
modules/service_detection.py1 symbols
modules/os_detection.py1 symbols

For agents

$ claude mcp add astsu \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact