IPs-LE

IPs-LE：1つのアドレスに、1つの表記

ドキュメント内のすべてのIPアドレス、CIDRブロック、MACアドレスを見つけて、正規化して分類し、曖昧なものは名前を示して拒否します
IPv4 · IPv6（RFC 5952）· CIDR · MAC — DNSも検索もソケットも使いません

役に立ちましたか？ 他の開発者に見つけてもらうには、スターや評価が役立ちます — ★ GitHub · ★ Open VSX · ★ Marketplace

できること

許可リストの確認では、2001:0db8::0001 がすでにリストにあるかどうかを調べます。リストには 2001:db8::1 と記載されています。生テキストを差分比較すると、別々の2つのアドレスに見えますが、実際は同じものです。

ドキュメントを開いて IPs-LE: Extract Addresses を実行すると、そこに含まれるすべてのIPv4アドレス、IPv6アドレス、CIDRブロック、MACアドレスが種類別に一覧表示されます。行と列、値が格納されているキー、その正規形式、用途（ループバック、プライベート、リンクローカル、ドキュメント用など）も確認できます。CIDRブロックには、ネットワーク、最終アドレス、含まれるアドレス数が表示されます。レポートはエディターの横に開きます。VS Codeのほか、CursorやVSCodiumなどのVS Codeベースのエディターでも利用できます（Open VSXからインストールできます）。

• 設定ファイルや許可リストを確認する — 各アドレスの表記を統一し、プライベートアドレスにはプライベートであることを明示します
• ログを読む — URL内や [host]:port の中にあるものも含め、すべてのピアとアップストリームを確認します
• 010.1.1.1 を信頼する前に確認する — 読み取る側によって、異なる2つのホストとして解釈される可能性があります
• プロジェクト全体を確認する — アドレスを含むすべてのファイルとその件数を、1つの表にまとめます

一意に解釈できないテキストは、推測せず理由とともに報告されます。 名前解決も検索も書き換えも行いません。

インストール

解決できること

ひとつのアドレスに、ひとつの形式。 IPv6 は RFC 5952 に従って正規化されます — 2001:0db8:0000:0000:0000:0000:0000:0001、2001:db8:0:0:0:0:0:1、 2001:0db8::0001、2001:DB8::1 は、すべて 2001:db8::1 として返されます。 元のテキストを並べ替えるとアドレスは4つですが、正規化した形式を並べ替えると 1つになります。

4種類。 ipv4、ipv6、cidr、mac。

10種類のクラス。 定義済みのものに限定されます。名前を付けられないクラスを、 このツールが対象だと主張することはありません。

IPv4 マップ IPv6 アドレスは IPv4 のクラスに分類されるため、::ffff:127.0.0.1 は global ではなく loopback になります。これこそ、許可リストの レビューで見つけたい見落としです。

場所。 行、列、そしてその値が属するキーを示します。JSON、YAML、 TOML、INI、dotenv、CSV、ログでは、いずれもキーのパスが得られます。 それ以外もスキャン対象です。検索はバイト列全体を対象とするため、.tf、.rules、 ローテーションされた access.log.1 からもアドレスが見つかりますが、キーのパスは得られません。

ブロックと、その計算値。 CIDR の検出結果には prefix、 network、broadcast（IPv4 のみ。IPv6 にはありません）、last、hosts が含まれます。 hosts は10進数の文字列です。::/0 には2^128個のアドレスが含まれ、 これは u128 の最大値をひとつ上回り、JSON の数値で扱える範囲をはるかに超えるためです。

{
  "kind": "cidr",
  "text": "10.0.0.0/8",
  "normalized": "10.0.0.0/8",
  "class": "private",
  "cidr": {
    "prefix": 8,
    "network": "10.0.0.0",
    "broadcast": "10.255.255.255",
    "last": "10.255.255.255",
    "hosts": "16777216"
  }
}

拒否するケース

テキストを複数の方法で解釈できる場合、ips-leはそのテキストを報告し、曖昧さの内容を示して処理を停止します。

理由は6つあり、いずれも2つの解釈が同じ程度に妥当なケースです。

特に重要なものは次の2つです。

• 010.1.1.1の解釈は確定しません。 先頭にゼロが付いたオクテットを8進数と解釈するリゾルバーもあれば、10進数と解釈するリゾルバーもあるため、このテキストは異なる2つのホストを指します。どちらの解釈も出力には現れません。片方を選ぶツールでは、バグが隠れてしまいます。
• 2130706433は、フラグの横にある場合にのみデコードされます。 アドレスを示すキーの下では、拒否メッセージに127.0.0.1を含めてinteger_formとして報告されます。フラグが消えた状態で、ループバックアドレスがアドレスのリストにひっそり現れることはありません。

拒否は検出結果であり、失敗ではありません。 終了コードには影響せず、どのフィルターでも隠せません。privateに絞り込んでも8進数の危険性は表示されます。フィルター適用後のレポートから除外された場合に最も問題となる検出結果だからです。未解決の曖昧さがあるとビルドを停止したいパイプライン向けに、--strictが用意されています。

各理由がいつ発生するかは、crate/SPEC.mdに正確に記載されています。

ネットワークには一切アクセスしません

DNS、位置情報、ASN、WHOIS、到達可能性の確認、テレメトリーは一切ありません。フラグで有効にする場合も含め、一度も行いません。分類はビットとIANAレジストリーを使った算術演算で行われます。照会を行うと、監査者が接続しているネットワークによって結果が変わってしまうためです。

ファイルを書き換えることも、判定を下すこともありません。アドレスが「何であるか」だけを示し、そこに存在すべきかどうかは判断しません。

フォルダーまたはワークスペース全体をスキャンする

Extract は、開いているドキュメントを読み取ります。スキャンではディスク上の多数のファイルを読み取り、1 つのレポートにまとめます。

• ワークスペース全体：コマンドパレットから IPs-LE: Scan Workspace for Addresses を実行します。
• 1 つのフォルダー：エクスプローラーでフォルダーを右クリックして Scan Folder for Addresses を選ぶか、IPs-LE: Scan Folder for Addresses を実行してフォルダーを選びます。

レポートが開き、対象の情報が含まれるすべてのファイルの表と、ファイルごとのセクションが表示されます。

# IPs-LE workspace report

`my-project` · 113 file(s) read · 2 address(es), 1 could not be read

| File | Addresses | Could not be read |
|---|---|---|
| `deploy/config.json` | 2 | 1 |

## `deploy/config.json` · json (2)

- **3:14** · `2001:0db8:0000:0000:0000:0000:0000:0001` · ipv6 · → `2001:db8::1` · documentation · key `upstream.host`
- **5:12** · `192.0.2.10` · ipv4 · documentation · key `peer`

> 2 file(s) larger than the safety limit were not read.

スキャンで読み取る内容。 ファイルはディスクから読み取るため、保存されていない編集内容は反映されません。安全上のサイズ上限を超えるファイルや、UTF-8 テキストではないファイルは読み取られません。5,000 ファイルまたは一覧表示されたアドレスが 10,000 件に達すると、スキャンは停止します。レポートの末尾には、除外された各項目が記載されるため、短いレポートをプロジェクトに問題がない証拠と誤解することはありません。

スキップされるものと変更方法。 3 つのスイッチはデフォルトでオンになっており、それぞれを設定で個別にオフにできます。

スイッチをオフにせずに結果を調整するリストが 2 つあります。さらにスキップするには、scanExcludes にパターンを追加します。スイッチによってスキップされるものを読み取るには、scanAlwaysInclude に追加します。

{
	// Also skip the test fixtures.
	"ips-le.workspace.scanExcludes": ["**/fixtures/**"],
	// Read the vendored code, though the built-in list skips it.
	"ips-le.workspace.scanAlwaysInclude": ["**/vendor/**"]
}

IPs-LE: Open Settings を実行すると、これらすべてが設定エディターで開きます。

読み取れなかったもの。 プロジェクトによっては数が多く、ほかの結果を埋もれさせることがあります。そのため、スキャンでは表にファイルごとの件数を表示し、項目自体は一覧表示しません。ips-le.workspace.scanIncludeRefusals には理由とともに各項目が表示され、ips-le.workspace.scanProblemsEnabled を有効にすると Problems パネルにも表示されます。そこでは各項目をクリックできます。

スキャンに影響する設定は、設定にあります。

位置

各行の先頭には、アドレスの行番号と列番号が表示されます。

- **3:14** · `2001:0db8:0000:0000:0000:0000:0000:0001` · → `2001:db8::1` · documentation · key `upstream.host`

ips-le.showPositions をオフにすると、同じ行は次のようになります。

- `2001:0db8:0000:0000:0000:0000:0000:0001` · → `2001:db8::1` · documentation · key `upstream.host`

それ以外は何も変わりません。行も件数も同じです。クリップボードへのコピーは別の設定 ips-le.clipboardIncludesPositions で指定するため、レポートには位置を表示しつつ、位置を含めずに貼り付けることができます。どちらの設定も、Extract と同様にスキャンに適用されます。

AI エージェントから使用する

同じエンジンがMCPサーバーとしても動作するため、2つの表記が同じアドレスかどうかを目視で判断する代わりに、エージェントから直接呼び出せます。

extract_ips(content, format?, filename?, kind?, class?, maxResults?)

エディターに表示される検出結果を、拒否された内容も含めてデータとして返します。デフォルトでは meta.truncated を付けて500件までに制限されます。ファイルの読み込みやネットワークリクエストは行いません。npmでは ips-le-mcp として、MCP レジストリでは io.github.nolindnaidoo/ips-le として公開されています。Rust CLIのサーバーとまったく同じ応答を返します。両方で同じコーパスを実行し、差分テストでは、形式ごとに何千もの生成ドキュメントを両方に入力して、すべての回答を比較します。パーサー自身のエラーメッセージと位置を両方が報告する不正なJSONも対象です。

{
  "mcpServers": {
    "ips-le": {
      "command": "npx",
      "args": ["-y", "ips-le-mcp"]
    }
  }
}

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y ips-le-mcp

CLI

同じ抽出処理を、ターミナルまたはCIのステップから、ディレクトリツリー全体に対して実行できます。拡張機能と同じコーパス — crate/fixtures/ — を共有するRust CLIがcrate/にあります。そのため、2つの実装でアドレスの読み取り方が異なることはありません。同じコマンドラインツールはnpmでも ips-le として提供されており、NodeはあるもののRustがないマシンでも使用できます。また、CIでは3つのオペレーティングシステム上で、クレートとバイト単位で一致することを検証しています。

npmからインストール (ips-le) するか、crates.ioからインストール (ips-le) してください。どちらからインストールしても、同じ ips-le コマンドが使えます。

npm install -g ips-le   # or run it once: npx ips-le
cargo install ips-le

ips-le .                                   # every address in the tree; one JSON line per file on stdout when piped
ips-le --class private --class loopback .  # what should not be reachable
ips-le --kind cidr infra/                  # every block, with its arithmetic
ips-le --strict config/                    # exit 2 on any ambiguity
ips-le mcp                                 # extract_ips and ips_le_scan over MCP on stdio

終了コードはgrepに準拠します — アドレスが1件以上見つかった場合は0、見つからなかった場合は1、質問の形式が不正な場合は2です。拒否されても終了コードは変わりません。パイプラインで拒否を失敗として扱うには --strict を使用します。

コマンド

デフォルトでは、どのコマンドにもキーは割り当てられていません。エディターのキーボードショートカットで、任意のコマンドにキーを割り当ててください。

設定

言語

英語以外に12言語に対応しています。

ドイツ語・スペイン語・フランス語・インドネシア語・イタリア語・日本語・韓国語・ ポルトガル語（ブラジル）・ロシア語・ウクライナ語・ベトナム語・中国語（簡体字）

マニフェスト（コマンドのタイトル、設定名と説明）と、拡張機能の実行中に表示されるすべての内容（通知、ステータスバー、レポートの見出し）の両方に対応しています。拒否の詳細はエンジンによる英語表記で、CLI の内容と同じです。

プライバシーとセキュリティ

• ネットワークアクセスはありません。 拡張機能がデータを外部に送信することはありません。DNS、位置情報の取得、あらゆる種類の照会も行いません。telemetryEnabled 設定は、確認できるローカルの出力チャンネル（IPs-LE）にイベントを書き込むだけです。
• MCP サーバーも同じ方針です。 引数としてコンテンツを受け取り、データを返します。ファイルシステムへのアクセス、ネットワーク呼び出し、テレメトリーはありません。
• エラー通知では、ホームディレクトリと認証情報のような形式の断片が伏せられます。
• 評価の案内は最大2回です。 3回目の正常な使用時に、評価するかどうかを一度尋ねます。後でを選んだ場合、または案内を閉じた場合は、20回目にもう一度だけ尋ねます。今後表示しないを選ぶと、案内は終了します。notificationsLevel を important または silent に自分で設定すると、案内は無効になります。回数は VS Code の拡張機能ストレージに保存され、データが外部に送信されることはありません。評価するを選ぶと、インストール元の掲載ページ（VS Code Marketplace または Open VSX）がブラウザーで開きます。

ドキュメント

パフォーマンス

Apple M5 Pro、RAM 24 GB、Node 24.3.0 で、ウォームアップ後に7回実行した中央値です。入力はチェックインされているのではなく、scripts/benchmark.ts によって生成されるため、上記のサイズは実測値と完全に一致します。bun run benchmark で再現できます。

これらの値はマシン固有であり、CI では保証されません — ビルドを妨げるベンチマークが示すのは、ランナーがどれだけビジーだったかにすぎません。

テスト

18個のファイルにわたる213件のテストケースに加え、実際の VS Code 拡張機能ホストで実行する統合テストスイートと、ビルド済みの .vsix をクリーンなプロファイルにインストールするエンドツーエンドテストがあります。

実際の実行結果である coverage/coverage-summary.json と coverage/test-results.json から scripts/coverage-readme.js によって生成されます。このセクションに差異があると CI は失敗します。bun run test:coverage で再現でき、ケース数は vitest が出力する値です。

LE ファミリーのその他のツール

あらゆるモデルが直面する作業に対応する、単機能ツールが16個あります。それぞれに Rust CLI と MCP サーバーが付属します。詳細はこちら：letools.dev

取り出す

• String-LE — コードベース内のすべての文字列を抽出し、人が読めるようにします
• Numbers-LE — コードベース内のすべてのハードコードされた数値を抽出し、人が確認できるようにします
• Units-LE — 単位付きの数量をすべて抽出して正規化し、曖昧なものは名前を示して対象外にします
• Dates-LE — すべての日付とタイムスタンプ、およびそれぞれが解決される正確な時点を抽出します
• IDs-LE — UUID、ULID、NanoID、ObjectId、Snowflakeをすべて抽出し、内部に含まれる時刻をデコードします
• IPs-LE — IPアドレス、CIDRブロック、MACアドレスをすべて抽出し、正規化してスコープ別に分類します
• URLs-LE — コードベース内のすべてのURLを、プロトコルと正確な位置情報とともに抽出します
• Paths-LE — コードベース内のすべてのファイルパスを抽出し、現在も何かを指しているかどうかを示します
• Colors-LE — コードベース内のすべての色を抽出し、パレットにない色を示します

チェックする

• Regex-LE — コードベース内のすべての正規表現を検出し、壊滅的なバックトラッキングを引き起こす可能性があるものを報告します
• Versions-LE — リポジトリ内のマニフェスト間で、同じ依存関係のバージョン制約が異なる箇所を検出します
• i18n-LE — プロジェクトで使用している i18n ライブラリを特定し、そのライブラリのルールに基づいてカタログを監査します
• Scrape-LE — スクレイパーを書く前にページをスクレイピングできるか確認し、判定できない場合はその旨を示します

保護する

• Secrets-LE — コードベース内のハードコードされた認証情報を検出し、レポートに表示することはありません
• EnvSync-LE — ディレクトリツリー内の dotenv ファイルを比較し、どのファイルにどのキーがないかを示します
• Unicode-LE — 意味を隠す Unicode を検出します。双方向制御文字、不可視文字、ホモグリフ、混在スクリプトが対象です

それぞれが独立しています。共有クレートも、公開されたコアもありません。2つのツールが同じ答えにたどり着くとすれば、それはその答えが2度正しかったからです。

お問い合わせ — nolindnaidoo.com · GitHub · LinkedIn

nolindnaidoo によるその他のプロジェクト

Rust — pixelcoords と pixelactions は一連のループを構成します。pixelcoords が 場所 に答え、pixelactions がそこで 操作 します。それぞれ独自のツールと独自の方針を持ち、LE ファミリーには属しません。

• pixelcoords — 画面を固定し、領域を指定して、ピクセル単位で正確な座標と切り抜きを取得します pixelcoords.dev · crates.io · docs.rs
• pixelactions — 人が検証した座標を受け取り、操作を実行して、反映されたことを確認します pixelactions.dev · crates.io · docs.rs

ライセンス

MIT © nolindnaidoo