Sounding

Netzwerkdiagnose MCP-Server

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.

Related MCP server: ProbeOps MCP Server

Tools

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