osv-scanner-mcp 0.9.0 → 0.10.0

package/README.md

@@ -136,6 +136,41 @@ npm run build
 >
 > 依存の情報をどこに送るかは[通信先とプライバシー](#通信先とプライバシー)を確認してください。どの設定でも、脆弱性照会のためパッケージの名前とバージョンは `api.osv.dev` に送られます。
 
+### 権限を絞って起動する
+
+多層防御として、Nodeの権限モデル(`--permission`)でサーバーが読み書きできる範囲を絞れます(任意。既定の起動方法は変わりません)。`npx` ではNodeのフラグを渡せないため、`node` で直接起動します。
+
+```json
+{
+  "mcpServers": {
+    "osv-scanner": {
+      "command": "node",
+      "args": [
+        "--permission",
+        "--allow-fs-read=/path/to/OSV-Scanner-MCP",
+        "--allow-fs-read=/Users/you/projects",
+        "--allow-fs-read=/var/folders/xx/yyyy/T",
+        "--allow-fs-read=/private/var/folders/xx/yyyy/T",
+        "--allow-fs-write=/private/var/folders/xx/yyyy/T",
+        "--allow-fs-read=/opt/homebrew/bin/osv-scanner",
+        "--allow-child-process",
+        "/path/to/OSV-Scanner-MCP/dist/index.js"
+      ],
+      "env": {
+        "OSV_MCP_ALLOWED_ROOT": "/Users/you/projects",
+        "OSV_SCANNER_PATH": "/opt/homebrew/bin/osv-scanner"
+      }
+    }
+  }
+}
+```
+
+- 読み取り: サーバー本体(`dist` と `node_modules` を含むディレクトリ)、スキャン対象(`OSV_MCP_ALLOWED_ROOT`)、一時ディレクトリ、osv-scannerのバイナリ
+- 一時ディレクトリ(`os.tmpdir()`、macOSでは `$TMPDIR`)は、**シンボリックリンクの解決前と解決後の両方のパス**に読み取りの許可が必要です(macOSの `/var/folders/...` は `/private/var/folders/...` へのリンク)。書き込みは解決後のパスに許可します
+- 自動ダウンロードを使う場合は、キャッシュ(`$XDG_CACHE_HOME/osv-scanner-mcp`、既定は `~/.cache/osv-scanner-mcp`)の読み書きも許可します。使わない場合は `OSV_SCANNER_PATH` を指定します
+- osv-scannerを起動するため `--allow-child-process` が必要です。**子プロセスのosv-scannerは権限モデルの制限を受けません**(Node自身もこのフラグは権限モデルを弱めると警告します)。osv-scannerには検証済みのコピーだけを渡しているため影響は限定的ですが、より強い隔離が必要ならコンテナ等のOSレベルの仕組みを併用してください
+- 必要な許可が欠けている場合は起動時に標準エラー出力へ警告し、スキャン時は `permission_denied`(不足している許可と対象のパス)を返します
+
 ### 通信先とプライバシー
 
 osv-scanner v2.4.0 で接続先を実機確認した結果です(2026-10-07)。
@@ -310,7 +345,8 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 **出力の読み方:**
 
 - 先頭の `coverage` に `jars_found`、`jars_identified`、`unidentified_jars` を返します。件数はWARも含む、ファイルシステム上で列挙した外側のアーカイブ単位です。ネストJARの総数ではありません。
-- `artifacts[].status` は `identified_with_vulnerabilities` / `identified_without_known_vulnerabilities` / `unidentified` の3値です。「同定済み」は少なくとも1件のMaven座標を取得できた意味であり、全依存の同定ではありません。
+- `artifacts[].status` は `identified_with_vulnerabilities` / `identified_without_known_vulnerabilities` / `inferred_only` / `unidentified` の4値です。「同定済み」は少なくとも1件のMaven座標を取得できた意味であり、全依存の同定ではありません。`inferred_only` は推測した座標(下記)だけで同定したアーカイブで、脆弱性が見つかった場合も含め `jars_identified` に数えず、`unidentified_jars` に理由付きで示します(検出件数は `identified_vulnerability_count` に示します。推測の誤ったgroupIdで他の脆弱性を取りこぼしている可能性があるため)。
+- **推測した座標**: `pom.properties` を含まないJAR(Spring Frameworkの本体JARなど)について、OSV-Scannerはファイル名等からMaven座標を推測し、groupIdを誤ることがあります(例: `spring-beans:spring-beans`。正しくは `org.springframework:spring-beans`)。誤った座標はOSVで照合されず、**既知の脆弱性を取りこぼします**(実例: zipkin-server 2.23.2 のfat JARに含まれる spring-beans 5.3.2 のSpring4Shell(CVE-2022-22965)は検出されません)。groupIdに `.` を含まない座標を推測とみなし、`coverage.inferred_coordinates`(件数・一覧・警告)と、該当パッケージの `coordinates_inferred: true` で示します。`commons-io:commons-io` のような古い形式の正しい座標も含まれます(安全側)。`.` を含む誤った推測(`com.sun.jna:jna` 等)は区別できません。正確な結果には、ビルド元のlockfile・`pom.xml` を `scan_project` でスキャンしてください
 - `coverage.completeness` は常に `incomplete`。`identified_vulnerability_count: 0` は安全性の保証ではありません。
 - `packages` は同定できた脆弱なパッケージの詳細です。複数アーカイブに含まれる同一パッケージ・脆弱性は全体集計では重複排除します。
 - JAR/WARが無い場合は `no_scannable_artifacts`、全件同定不能の場合は警告を含む成功レポートです。
@@ -434,6 +470,7 @@ npm・Go・PyPIの「同じ系統」は、npmの `^`(キャレット)が互換
 |---|---|
 | `binary_not_found` | OSV-Scannerが見つからない(インストール案内をmessageに含む) |
 | `project_not_found` | 指定パスが存在しない・ディレクトリ/pom.xmlでない |
+| `permission_denied` | Nodeの権限モデル(`--permission`)でファイルの読み書きが許可されていない(メッセージに不足している許可と対象のパスを示します。[権限を絞って起動する](#権限を絞って起動する)を参照) |
 | `no_manifest_found` | 対応マニフェスト(pom.xml / gradle.lockfile)が見つからない |
 | `scan_input_too_large` | スキャン対象ファイル(一時ディレクトリへのコピー)の合計サイズが上限(2GiB)を超えた。対象を絞って再実行する |
 | `manifest_search_limit_exceeded` | マニフェスト探索が上限(20万エントリ・1,000マニフェスト)に達した。より狭いディレクトリかマニフェストを直接指定する |

package/dist/index.js

@@ -21,6 +21,10 @@ import { handleScanProject } from "./tools/scanProject.js";
 import { handleScanJavaArtifact } from "./tools/scanJavaArtifact.js";
 import { handleScanSbom } from "./tools/scanSbom.js";
 import { handleSuggestFix } from "./tools/suggestFix.js";
+import { realpathSync } from "node:fs";
+import os from "node:os";
+import { defaultCacheDir } from "./osv/binaryDownloader.js";
+import { permissionModelWarnings } from "./utils/permissionCheck.js";
 import { installShutdownHandlers, removeStaleTempDirs } from "./utils/processCleanup.js";
 import { ALLOWED_ROOT_ENV, allowedRootFromEnv, allowedRootStartupError, allowedRootStartupWarning, } from "./utils/startupConfig.js";
 export { ALLOWED_ROOT_ENV };
@@ -35,10 +39,29 @@ const startupWarning = allowedRootStartupWarning();
 if (startupWarning !== null) {
     console.error(`osv-scanner-mcp: [警告] ${startupWarning}`);
 }
+// Nodeの権限モデル(--permission)で起動された場合、必要な許可が欠けていればstderrで知らせる(起動は続ける)
+{
+    const tmpDir = os.tmpdir();
+    let tmpDirReal = tmpDir;
+    try {
+        tmpDirReal = realpathSync(tmpDir);
+    }
+    catch { /* 解決前のパスの読み取りが拒否されている場合も、警告で示す */ }
+    const scannerPath = process.env.OSV_SCANNER_PATH?.trim();
+    for (const warning of permissionModelWarnings({
+        allowedRoot: allowedRootFromEnv(),
+        tmpDir,
+        tmpDirReal,
+        cacheDir: scannerPath ? undefined : defaultCacheDir(),
+        scannerPath: scannerPath || undefined,
+    })) {
+        console.error(`osv-scanner-mcp: [警告] ${warning}`);
+    }
+}
 // NOTE: リリース時はpackage.jsonのversionと同じ値に更新すること
 const server = new McpServer({
     name: "osv-scanner-mcp",
-    version: "0.9.0",
+    version: "0.10.0",
 });
 server.registerTool("scan_project", {
     title: "プロジェクトの依存の脆弱性スキャン(Java / JavaScript / Python / Go)",
@@ -104,6 +127,7 @@ server.registerTool("scan_java_artifact", {
     title: "JAR/WAR実体の脆弱性スキャン",
     description: "JAR/WARファイルまたはディレクトリ内の実体をスキャンする。ビルドやJavaコードの実行は行わない。" +
         "メタデータによるベストエフォート同定のため、coverageと同定不能ファイルを必ず確認すること。" +
+        "pom.propertiesのないJARは座標を推測し、groupIdの誤りで既知の脆弱性を取りこぼしうる(coverage.inferred_coordinates、status: inferred_only)。" +
         "completenessは常にincomplete。検出0件でも安全性や全依存の同定を保証しない。",
     inputSchema: {
         artifact_path: z.string().min(1).describe("JAR/WARファイル、または探索するディレクトリの絶対パス"),

package/dist/osv/artifactReport.js

@@ -4,6 +4,23 @@ import { asArray, asRecord } from "../utils/unknownJson.js";
 import { parseOsvScanOutput } from "./scanReport.js";
 const WARNING = "Best-effort metadata identification only. Missing or removed metadata can hide dependencies, even in identified archives. Zero identified vulnerabilities does not establish safety.";
 const HINT = "Metadata may be missing (shaded/minimized archive). Scan the build project's lockfile instead.";
+const INFERRED_WARNING = "Some Maven coordinates were inferred from file names because the JAR has no pom.properties (inferred_coordinates). " +
+    "Inferred groupIds are often wrong (e.g. spring-beans:spring-beans instead of org.springframework:spring-beans), " +
+    "so known vulnerabilities of these packages may be missed. Scan the build project's lockfile or pom.xml (scan_project) for accurate results.";
+const INFERRED_HINT = "Identified only by inferred coordinates (no pom.properties). Known vulnerabilities may be missed.";
+/** coverage.inferred_coordinatesの上限(巨大なWARで応答を膨らませない) */
+const MAX_INFERRED_ITEMS = 200;
+/**
+ * osv-scannerがpom.propertiesのないJARについて、ファイル名等から推測した座標か(B3の実物の検証で判明)。
+ * 推測の座標はgroupIdを誤りやすく(`spring-beans:spring-beans`、`jar:grpc-netty-shaded`、`all:opentelemetry-api`)、
+ * OSVで照会しても0件になり既知の脆弱性を取りこぼす。osv-scannerの出力には座標の出所がないため、
+ * groupIdに`.`がないものを推測とみなす。`commons-io:commons-io`のような古い形式の正しい座標も含む(安全側)。
+ * `.`を含む誤った推測(`com.sun.jna:jna`)は区別できない
+ */
+export function isInferredCoordinate(name) {
+    const groupId = name.split(":")[0] ?? "";
+    return !groupId.includes(".");
+}
 function isIdentifiedPackage(raw) {
     const info = asRecord(asRecord(raw)?.package);
     if (info?.ecosystem !== "Maven" || typeof info.name !== "string" || typeof info.version !== "string")
@@ -31,30 +48,53 @@ export function buildArtifactReport(raw, artifactPaths) {
     }
     const normalized = [...byPath].map(([file, packages]) => ({ source: { path: file }, packages }));
     const report = parseOsvScanOutput({ results: normalized });
+    const coordinateOf = (raw) => {
+        const info = asRecord(asRecord(raw)?.package);
+        return { name: String(info.name), version: String(info.version) };
+    };
     const artifacts = artifactPaths.map((file) => {
         const packages = byPath.get(file);
-        const identified = packages !== undefined;
         const perFile = parseOsvScanOutput({ results: [{ packages: packages ?? [] }] });
+        // 推測の座標だけで同定したアーカイブは、脆弱性の有無に関係なく「同定済み」にしない(同定の確度と検出件数を分ける)。
+        // 脆弱性が見つかっても、推測の誤ったgroupIdで他の脆弱性を取りこぼしている可能性がある
+        const inferredOnly = packages !== undefined && packages.every((raw) => isInferredCoordinate(coordinateOf(raw).name));
         return {
             path: sanitizeExternalText(file),
-            status: !identified ? "unidentified" : perFile.vulnerability_count > 0
+            status: packages === undefined ? "unidentified" : inferredOnly ? "inferred_only" : perFile.vulnerability_count > 0
                 ? "identified_with_vulnerabilities" : "identified_without_known_vulnerabilities",
             identified_vulnerability_count: perFile.vulnerability_count,
         };
     });
+    // 推測の座標の一覧(既知の脆弱性のないものも含む。名前と版で重複を除く)
+    const inferred = [...new Map([...byPath.values()].flat().map(coordinateOf)
+            .filter((c) => isInferredCoordinate(c.name)).map((c) => [`${c.name}@${c.version}`, c])).values()]
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
     return {
         coverage: {
             jars_found: artifactPaths.length,
-            jars_identified: byPath.size,
-            unidentified_jars: artifacts.filter((item) => item.status === "unidentified")
-                .map(({ path }) => ({ path, hint: HINT })),
+            jars_identified: artifacts.filter((item) => item.status !== "unidentified" && item.status !== "inferred_only").length,
+            unidentified_jars: artifacts.filter((item) => item.status === "unidentified" || item.status === "inferred_only")
+                .map(({ path, status }) => ({ path, hint: status === "inferred_only" ? INFERRED_HINT : HINT })),
             completeness: "incomplete",
             warning: WARNING,
+            ...(inferred.length > 0 ? {
+                inferred_coordinates: {
+                    count: inferred.length,
+                    items: inferred.slice(0, MAX_INFERRED_ITEMS).map((c) => ({ name: sanitizeExternalText(c.name), version: sanitizeExternalText(c.version) })),
+                    ...(inferred.length > MAX_INFERRED_ITEMS ? { omitted: inferred.length - MAX_INFERRED_ITEMS } : {}),
+                    warning: INFERRED_WARNING,
+                },
+            } : {}),
         },
         artifacts,
         identified_vulnerability_count: report.vulnerability_count,
         identified_vulnerable_package_count: report.vulnerable_package_count,
         severity_breakdown: report.severity_breakdown,
-        packages: report.packages,
+        packages: report.packages.map((pkg) => {
+            if (!isInferredCoordinate(pkg.name))
+                return pkg;
+            const { vulnerabilities, ...rest } = pkg;
+            return { ...rest, coordinates_inferred: true, vulnerabilities };
+        }),
     };
 }

package/dist/osv/binaryDownloader.js

@@ -47,7 +47,7 @@ export function assetNameForPlatform(platform = process.platform, arch = process
         return null;
     return `osv-scanner_${osName}_${cpuName}${osName === "windows" ? ".exe" : ""}`;
 }
-function defaultCacheDir() {
+export function defaultCacheDir() {
     const xdg = process.env.XDG_CACHE_HOME;
     const base = xdg !== undefined && xdg.trim() !== "" ? xdg : path.join(os.homedir(), ".cache");
     return path.join(base, "osv-scanner-mcp");

package/dist/osv/binaryManager.js

@@ -4,11 +4,16 @@
  * 探索順: 環境変数 OSV_SCANNER_PATH → PATH上の osv-scanner
  */
 import { access, constants, stat } from "node:fs/promises";
+import { isAccessDenied, permissionDeniedError } from "../utils/projectWalk.js";
 import path from "node:path";
 import { ScanToolError } from "../errors.js";
 export const OSV_SCANNER_PATH_ENV = "OSV_SCANNER_PATH";
 const BINARY_NAME = process.platform === "win32" ? "osv-scanner.exe" : "osv-scanner";
-async function isExecutableFile(filePath) {
+/**
+ * 実行可能な通常のファイルか。rethrowDeniedのとき、Nodeの権限モデル(--permission)による拒否は
+ * 「見つからない」にせず投げる(明示指定のパスで原因を誤らせない。PATHの探索では読めない場所を飛ばす)
+ */
+async function isExecutableFile(filePath, rethrowDenied = false) {
     try {
         const stats = await stat(filePath);
         if (!stats.isFile())
@@ -16,7 +21,9 @@ async function isExecutableFile(filePath) {
         await access(filePath, constants.X_OK);
         return true;
     }
-    catch {
+    catch (error) {
+        if (rethrowDenied && isAccessDenied(error))
+            throw permissionDeniedError(error);
         return false;
     }
 }
@@ -25,7 +32,7 @@ export async function findOsvScannerBinary(env = process.env) {
     const explicit = env[OSV_SCANNER_PATH_ENV];
     if (explicit !== undefined && explicit.trim() !== "") {
         // 明示指定が無効な場合はPATHにフォールバックせず失敗させる(意図しないバイナリの実行を防ぐ)
-        return (await isExecutableFile(explicit)) ? explicit : null;
+        return (await isExecutableFile(explicit, true)) ? explicit : null;
     }
     for (const dir of (env.PATH ?? "").split(path.delimiter)) {
         if (dir === "")

package/dist/osv/scanReport.js

@@ -165,7 +165,11 @@ export function parseOsvScanOutput(raw) {
                     severity: severityFromScore(score),
                     summary: extractSummary(vulnDetails),
                     fixed_versions: extractFixedVersions(vulnDetails, name, ecosystem),
-                    affected_versions: extractAffectedVersions(vulnDetails, ids, name, ecosystem),
+                });
+                // 内部でだけ使うため列挙不可にする(JSON.stringifyに含まれない)
+                Object.defineProperty(entry.vulns.get(primaryId), "affected_versions", {
+                    value: extractAffectedVersions(vulnDetails, ids, name, ecosystem),
+                    enumerable: false,
                 });
             }
         }

package/dist/tools/toolResult.js

@@ -8,6 +8,7 @@
  */
 import { ScanToolError } from "../errors.js";
 import { sanitizeExternalText } from "../utils/externalText.js";
+import { isAccessDenied, permissionDeniedError } from "../utils/projectWalk.js";
 export function jsonResult(payload, isError = false) {
     return {
         content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
@@ -28,6 +29,9 @@ export function errorResult(error) {
             },
         }, true);
     }
+    // Nodeの権限モデルの拒否は、許可の付け方が分かるエラーにする(内部の例外の詳細は返さない)
+    if (isAccessDenied(error))
+        return errorResult(permissionDeniedError(error));
     // 想定外の例外はスタックトレース等の内部情報をクライアントへ返さない
     return jsonResult({ error: { kind: "internal_error", message: "予期しないエラーが発生しました" } }, true);
 }

package/dist/utils/artifactDetector.js

@@ -1,6 +1,7 @@
 import { opendir, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { ScanToolError } from "../errors.js";
+import { isAccessDenied, permissionDeniedError } from "./projectWalk.js";
 // Build output directories must be included for artifact scans.
 const SKIPPED_DIRS = new Set([".git", "node_modules", ".idea", ".vscode"]);
 const isArchive = (file) => /\.(jar|war)$/i.test(file);
@@ -12,7 +13,10 @@ export async function detectJavaArtifacts(inputPath, options = {}) {
     try {
         targetPath = await realpath(inputPath);
     }
-    catch {
+    catch (error) {
+        // Nodeの権限モデルの拒否を「存在しない」と誤って伝えない
+        if (isAccessDenied(error))
+            throw permissionDeniedError(error);
         throw new ScanToolError("project_not_found", `Path does not exist: ${inputPath}`);
     }
     if (options.allowedRoot !== undefined) {

package/dist/utils/permissionCheck.js

@@ -0,0 +1,38 @@
+/**
+ * Nodeの権限モデル(--permission)で起動された場合の、必要な許可の確認(docs/DESIGN_TODO.md「B3」)。
+ *
+ * 権限モデルは任意の多層防御として使える(既定の起動方法は変えない)。必要な許可が欠けると
+ * スキャンの途中でERR_ACCESS_DENIEDになるため、起動時にstderrで知らせる(起動は拒否しない)。
+ * 子プロセス(osv-scanner)は権限モデルの制限を受けない点に注意(READMEに明記)。
+ */
+import path from "node:path";
+/** 権限モデルが有効なときに、欠けている許可を警告文の一覧で返す。無効なら空 */
+export function permissionModelWarnings(input, permission = process.permission) {
+    if (permission === undefined)
+        return [];
+    const inside = (dir) => path.join(dir, "x"); // ディレクトリ配下の読み書きの許可を確かめる
+    const warnings = [];
+    if (!permission.has("child")) {
+        warnings.push("子プロセスの起動が許可されていません。osv-scannerを実行できません(--allow-child-process)");
+    }
+    const tmpDirs = [...new Set([input.tmpDir, input.tmpDirReal])];
+    const unreadableTmp = tmpDirs.filter((dir) => !permission.has("fs.read", inside(dir)));
+    if (unreadableTmp.length > 0) {
+        warnings.push(`一時ディレクトリの読み取りが許可されていません: ${unreadableTmp.join(", ")}` +
+            "(シンボリックリンクの解決前と解決後の両方のパスに--allow-fs-readが必要です)");
+    }
+    if (!permission.has("fs.write", inside(input.tmpDirReal))) {
+        warnings.push(`一時ディレクトリへの書き込みが許可されていません: ${input.tmpDirReal}(--allow-fs-write)`);
+    }
+    if (input.allowedRoot !== undefined && !permission.has("fs.read", inside(input.allowedRoot))) {
+        warnings.push(`OSV_MCP_ALLOWED_ROOTの読み取りが許可されていません: ${input.allowedRoot}(--allow-fs-read)`);
+    }
+    if (input.scannerPath !== undefined && !permission.has("fs.read", input.scannerPath)) {
+        warnings.push(`OSV_SCANNER_PATHの読み取りが許可されていません: ${input.scannerPath}(--allow-fs-read)`);
+    }
+    if (input.cacheDir !== undefined && !permission.has("fs.write", inside(input.cacheDir))) {
+        warnings.push(`osv-scannerのキャッシュへの書き込みが許可されていません: ${input.cacheDir}` +
+            "(自動ダウンロードを使う場合は--allow-fs-writeと--allow-fs-read、使わない場合はOSV_SCANNER_PATHを指定)");
+    }
+    return warnings;
+}

package/dist/utils/projectWalk.js

@@ -10,11 +10,26 @@ import { ScanToolError } from "../errors.js";
 const DEFAULT_MAX_DEPTH = 64;
 const DEFAULT_MAX_ENTRIES = 200_000;
 const DEFAULT_MAX_MANIFESTS = 1_000;
+/** Nodeの権限モデル(--permission)による拒否か */
+export function isAccessDenied(error) {
+    return error instanceof Error && error.code === "ERR_ACCESS_DENIED";
+}
+/** 権限モデルの拒否を、許可の付け方が分かるエラーにする */
+export function permissionDeniedError(error) {
+    const resource = typeof error.resource === "string" ? `: ${error.resource}` : "";
+    const kind = error.permission === "FileSystemWrite" ? "書き込み(--allow-fs-write)" : error.permission === "ChildProcess"
+        ? "子プロセスの起動(--allow-child-process)" : "読み取り(--allow-fs-read)";
+    return new ScanToolError("permission_denied", `Nodeの権限モデル(--permission)で${kind}が許可されていません${resource}。` +
+        "スキャン対象・一時ディレクトリ(シンボリックリンクの解決前と解決後の両方のパス)・osv-scannerのキャッシュへの許可が必要です(READMEの「権限を絞って起動する」を参照)");
+}
 export async function resolveExistingPath(inputPath) {
     try {
         return await realpath(path.resolve(inputPath));
     }
-    catch {
+    catch (error) {
+        // Nodeの権限モデルの拒否を「存在しない」と誤って伝えない
+        if (isAccessDenied(error))
+            throw permissionDeniedError(error);
         throw new ScanToolError("project_not_found", `指定されたパスが存在しません: ${inputPath}`);
     }
 }
@@ -54,8 +69,11 @@ export async function walkProjectFiles(rootDir, options, skippedDirs, onFile) {
             try {
                 entries = await readdir(dir, { withFileTypes: true });
             }
-            catch {
-                continue; // 読めないディレクトリはスキップ(権限不足等)
+            catch (error) {
+                // Nodeの権限モデルの拒否は、スキャン範囲を黙って欠落させずにエラーにする
+                if (isAccessDenied(error))
+                    throw permissionDeniedError(error);
+                continue; // 読めないディレクトリはスキップ(OSの権限不足等)
             }
             for (const entry of entries) {
                 if (++visited > limits.maxEntries)

package/dist/utils/safeRead.js

@@ -14,10 +14,11 @@
  */
 import { constants } from "node:fs";
 import { open, realpath, rm, stat } from "node:fs/promises";
-import { isInsideDir } from "./projectWalk.js";
+import { isAccessDenied, isInsideDir } from "./projectWalk.js";
 const OPEN_FLAGS = constants.O_RDONLY | (constants.O_NONBLOCK ?? 0) | (constants.O_NOFOLLOW ?? 0);
 const MESSAGES = {
     not_found: "ファイルを開けません",
+    denied: "Nodeの権限モデル(--permission)で読み取りが許可されていません",
     not_regular: "通常のファイルではありません(名前付きパイプ・デバイス等)",
     too_large: "サイズが上限を超えています",
     outside: "スキャン範囲の外のファイルです",
@@ -56,8 +57,8 @@ export async function copyRegularFile(filePath, dest, options) {
     try {
         source = await open(filePath, OPEN_FLAGS);
     }
-    catch {
-        return failure("not_found");
+    catch (error) {
+        return failure(isAccessDenied(error) ? "denied" : "not_found");
     }
     let total = 0;
     let result = null;
@@ -114,8 +115,8 @@ export async function readRegularFile(filePath, options) {
     try {
         handle = await open(filePath, OPEN_FLAGS);
     }
-    catch {
-        return failure("not_found");
+    catch (error) {
+        return failure(isAccessDenied(error) ? "denied" : "not_found");
     }
     let info;
     const chunks = [];

package/dist/utils/sbomInput.js

@@ -3,6 +3,7 @@ import { constants } from "node:fs";
 import { open, realpath } from "node:fs/promises";
 import path from "node:path";
 import { ScanToolError } from "../errors.js";
+import { isAccessDenied, permissionDeniedError } from "./projectWalk.js";
 import { verifyOpenedFile } from "./safeRead.js";
 import { asRecord } from "./unknownJson.js";
 const DEFAULT_MAX_INPUT_BYTES = 16 * 1024 * 1024;
@@ -16,7 +17,10 @@ export async function loadSbom(inputPath, options = {}) {
     try {
         sourcePath = await realpath(inputPath);
     }
-    catch {
+    catch (error) {
+        // Nodeの権限モデルの拒否を「存在しない」と誤って伝えない
+        if (isAccessDenied(error))
+            throw permissionDeniedError(error);
         throw new ScanToolError("sbom_not_found", "The specified SBOM file does not exist");
     }
     if (options.allowedRoot !== undefined) {
@@ -69,6 +73,8 @@ export async function loadSbom(inputPath, options = {}) {
     catch (error) {
         if (error instanceof ScanToolError)
             throw error;
+        if (isAccessDenied(error))
+            throw permissionDeniedError(error);
         throw new ScanToolError("sbom_not_found", "The specified SBOM file could not be read");
     }
     let raw;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osv-scanner-mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "MCP server that wraps Google's OSV-Scanner to scan Java projects for known vulnerabilities",
   "type": "module",
   "license": "Apache-2.0",