Sounding

ネットワーク診断 MCP サーバー

水面下を探る -- AIツール向けのネットワーク診断。

機能

Soundingは、AIアシスタントに14種類のネットワーク診断ツールを提供するModel Context Protocol (MCP) サーバーです。通常であれば ping、dig、nmap、または openssl を使用して行う作業を、構造化され検証されたMCPツール呼び出しとして実行します。

ツール

インストール

PyPIから:

pip install sounding-mcp

またはpipxで分離してインストール:

pipx install sounding-mcp

使用方法

サーバーを直接実行（stdioトランスポート）:

sounding

Claude Code

ローカルMCPサーバーとして登録:

claude mcp add sounding -- sounding

Claude Desktop

claude_desktop_config.json に追加:

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

仮想環境にインストールされている場合は、バイナリへのフルパスを使用してください:

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

セキュリティ

SoundingはAI駆動の利用において安全であるように設計されています:

• SSRF保護 -- http_check はホスト名を解決し、内部、プライベート、ループバック、リンクローカルIPアドレス（IPv4マップされたIPv6を含む）へのリクエストをブロックします。クラウドメタデータエンドポイント (169.254.x.x) はブロックされます。

• 入力検証 -- すべての入力はバリデーターを通過し、ネットワーク呼び出しやサブプロセスに到達する前に、シェルのメタ文字、不正な形式のホスト名、無効なポートを拒否します。

• レート制限 -- port_scan は、悪用を防ぐためにスキャン間に最低1秒の間隔を強制します。

• サブネット制限 -- subnet_scan はRFC 1918プライベートサブネットのみを許可し、同時実行制限を設けた上で /20 (4096アドレス) に制限します。

• シェルインジェクション対策 -- サブプロセス呼び出し (traceroute, whois) は exec 形式の呼び出しを使用し、シェル補間は一切行いません。

開発

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

ライセンス

MIT