Sounding

Netzwerkdiagnose MCP-Server

License: MIT

Ergründung dessen, was unter der Oberfläche liegt -- Netzwerkdiagnose für KI-Tools.

Was es tut

Sounding ist ein Model Context Protocol (MCP) Server, der KI-Assistenten 14 Netzwerkdiagnose-Tools zur Verfügung stellt. Er erledigt die Aufgaben, für die man normalerweise zu ping, dig, nmap oder openssl greifen würde -- jedoch bereitgestellt als strukturierte, validierte MCP-Tool-Aufrufe.

Tools

Tool	Beschreibung	Wichtige Parameter
`health`	Server-Version und Statusprüfung	--
`ping`	TCP-Connect-Ping (Port 80) mit Latenzstatistiken	`host`, `count` (1--100), `timeout`
`traceroute`	Verfolgung der Netzwerkroute zu einem Host	`host`, `max_hops` (1--64)
`dns_lookup`	Auflösung von DNS-Einträgen (A, AAAA, MX, CNAME, TXT, NS)	`domain`, `record_type`, `nameserver`
`reverse_dns`	Reverse-DNS-Lookup für eine IP-Adresse	`ip`
`port_check`	Überprüfung, ob ein einzelner TCP-Port offen ist	`host`, `port`, `timeout`
`port_scan`	Scan gängiger TCP-Ports (ratenbegrenzt, max. 100)	`host`, `ports`
`check_ssl_cert`	Überprüfung von SSL/TLS-Zertifikatsdetails und Ablaufdatum	`host`, `port`
`whois_lookup`	WHOIS-Domain-Registrierungsabfrage	`domain`
`http_check`	HTTP-Anfrage mit Status, Timing, Headern, Größe	`url`
`subnet_scan`	Entdeckung aktiver Hosts in einem lokalen Subnetz (nur RFC 1918)	`subnet` (CIDR, max. /20)
`get_public_ip`	Abruf der öffentlichen IP-Adresse des Rechners	--
`speed_test`	Messung der Download-Geschwindigkeit (Mbps) und Latenz	--
`dns_propagation`	Überprüfung der DNS-Propagierung über öffentliche Resolver	`domain`, `record_type`

Installation

Über PyPI:

pip install sounding-mcp

Oder isoliert mit pipx:

pipx install sounding-mcp

Verwendung

Starten Sie den Server direkt (stdio-Transport):

sounding

Claude Code

Registrierung als lokaler MCP-Server:

claude mcp add sounding -- sounding

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "sounding": {
      "command": "sounding",
      "args": []
    }
  }
}

Falls in einer virtuellen Umgebung installiert, verwenden Sie den vollständigen Pfad zur Binärdatei:

{
  "mcpServers": {
    "sounding": {
      "command": "/path/to/.venv/bin/sounding",
      "args": []
    }
  }
}

Sicherheit

Sounding wurde für den sicheren Einsatz durch KI entwickelt:

SSRF-Schutz -- http_check löst Hostnamen auf und blockiert Anfragen an interne, private, Loopback- und Link-Local-IP-Adressen (einschließlich IPv4-mapped IPv6). Cloud-Metadaten-Endpunkte (169.254.x.x) werden blockiert.
Eingabevalidierung -- Alle Eingaben durchlaufen Validatoren, die Shell-Metazeichen, fehlerhafte Hostnamen und ungültige Ports ablehnen, bevor sie einen Netzwerkaufruf oder Subprozess erreichen.
Ratenbegrenzung -- port_scan erzwingt ein Mindestintervall von 1 Sekunde zwischen Scans, um Missbrauch zu verhindern.
Subnetz-Beschränkung -- subnet_scan erlaubt nur private RFC 1918-Subnetze und ist auf /20 (4096 Adressen) mit gleichzeitiger Begrenzung beschränkt.
Keine Shell-Injection -- Subprozess-Aufrufe (traceroute, whois) verwenden exec-artige Aufrufe, niemals Shell-Interpolation.

Entwicklung

git clone https://github.com/seayniclabs/sounding.git
cd sounding
python -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q

Lizenz

MIT

Keel