osv-scanner-mcp 0.3.2 → 0.3.4

package/README.md

@@ -25,7 +25,7 @@ Google製 [OSV-Scanner](https://github.com/google/osv-scanner) をラップす
   - 手動インストール済みのバイナリ(PATH上または `OSV_SCANNER_PATH` 指定)があればそちらを優先します
   - 自動ダウンロードを無効化する場合は `OSV_MCP_AUTO_DOWNLOAD=0`
   - PATH上のバイナリを使わず常に検証済み自動ダウンロードを使う場合は `OSV_MCP_PREFER_DOWNLOAD=1`(運用環境向け)
-- スキャン時(OSV-Scanner経由)および `explain_vulnerability` 実行時に `api.osv.dev` へのネットワークアクセスが発生します(照会先はOSVデータベースのみ)
+- スキャン時と `explain_vulnerability` 実行時にネットワークアクセスが発生します。照会先はOSVデータベース(`api.osv.dev`)ですが、**`pom.xml` のスキャンでは推移的依存を解決するため deps.dev(`api.deps.dev`)にも接続します**。詳細と無効化の方法は[通信先とプライバシー](#通信先とプライバシー)を参照してください
 
 ## セットアップ
 
@@ -123,6 +123,7 @@ npm run build
 | `OSV_MCP_MAX_CONCURRENT_SCANS` | 同時実行できるスキャン数の上限(デフォルト `2`、最大 `16`)。超過したリクエストは待たずに即時エラーになります |
 | `OSV_MCP_AUTO_DOWNLOAD` | `0` または `false` でバイナリの自動ダウンロードを無効化(デフォルト有効) |
 | `OSV_MCP_PREFER_DOWNLOAD` | `1` または `true` 指定時、PATH上のosv-scannerを使わず、チェックサム検証済みの自動ダウンロードバイナリを常に使用します(PATH汚染による偽バイナリ実行の防止。`OSV_SCANNER_PATH` の明示指定は引き続き最優先) |
+| `OSV_MCP_NO_REMOTE_RESOLUTION` | `1` または `true` 指定時、`pom.xml` の推移的依存を deps.dev で解決しません。**止まるのは deps.dev への送信だけで、脆弱性照会のためパッケージの名前とバージョンは引き続き `api.osv.dev` に送られます**。推移的依存の脆弱性は検出できなくなり、その旨が応答の `dependency_resolution.warning` に示されます。詳細は[通信先とプライバシー](#通信先とプライバシー) |
 
 > **推奨**: `OSV_MCP_ALLOWED_ROOT` は未設定でも動作しますが、その場合は任意の絶対パスをスキャンできてしまいます。悪意ある指示(プロンプトインジェクション)経由で意図しないディレクトリをスキャンさせられる経路を塞ぐため、プロジェクト置き場のルート(例: `~/projects`)を設定しておくことを推奨します。各クライアントの設定で `"env": {"OSV_MCP_ALLOWED_ROOT": "/Users/you/projects"}` のように渡せます(Codex CLIのTOMLでは `[mcp_servers.osv-scanner.env]` セクション)。
 
@@ -130,6 +131,25 @@ npm run build
 > - `OSV_MCP_ALLOWED_ROOT=/スキャン対象のルート` — スキャン範囲の境界を固定
 > - `OSV_MCP_REQUIRE_ALLOWED_ROOT=1` — 境界未設定なら起動を拒否(fail-closed)
 > - `OSV_SCANNER_PATH=/管理者所有の絶対パス` または `OSV_MCP_PREFER_DOWNLOAD=1` — PATH解決に依存せず、実行するバイナリを固定
+>
+> 依存の情報をどこに送るかは[通信先とプライバシー](#通信先とプライバシー)を確認してください。どの設定でも、脆弱性照会のためパッケージの名前とバージョンは `api.osv.dev` に送られます。
+
+### 通信先とプライバシー
+
+osv-scanner v2.4.0 で接続先を実機確認した結果です(2026-10-07)。
+
+| 操作 | 接続先 | 送られる情報 |
+|---|---|---|
+| `pom.xml` のスキャン(`scan_java_project` / `suggest_fix`) | `api.osv.dev`、**`api.deps.dev`** | パッケージの名前とバージョン。deps.dev には推移的依存の解決のため、`pom.xml` に宣言された依存(社内パッケージを含む)の名前とバージョンが送られます |
+| `gradle.lockfile` のスキャン | `api.osv.dev` | パッケージの名前とバージョン(lockfileに全依存が記載済みのため、解決のための外部接続はしません) |
+| `scan_java_artifact` / `scan_sbom` | `api.osv.dev` | 同定できたパッケージの名前とバージョン |
+| `explain_vulnerability` | `api.osv.dev` | 指定した脆弱性ID |
+| バイナリの自動ダウンロード(初回のみ) | GitHub(公式Releases) | なし(ピン留めしたバージョンのバイナリを取得) |
+
+api.osv.dev と deps.dev はどちらも Google が運営するサービスです。**どの設定でも、スキャンしたパッケージの名前とバージョンは脆弱性照会のため `api.osv.dev` に送られます**(オフラインでの照会には対応していません)。
+
+- **deps.dev への送信を止めたい場合**: `OSV_MCP_NO_REMOTE_RESOLUTION=1` を設定すると、`pom.xml` の推移的依存を解決しなくなり、接続先は `api.osv.dev` だけになります。止まるのは deps.dev への送信だけで、OSV への送信は続きます。また `pom.xml` に直接書いた依存しかスキャンされず、**推移的依存の脆弱性を見落とします**。この状態は `scan_java_project` / `suggest_fix` の応答の `dependency_resolution` に `transitive_resolution: "disabled"` と警告で示されるので、検出0件と区別できます。推移的依存も含めて deps.dev を使わずにスキャンするには、Gradleのlockfile方式(`gradle.lockfile`)を使ってください
+- **任意の取得先には接続しません**: osv-scanner の `--data-source native` モードは、スキャン対象の `pom.xml` の `<repositories>` に書かれた任意のURLへ接続します(悪意あるpom.xmlで攻撃者のサーバーへ通信させられる)。本サーバーはこのモードを使わず、`deps.dev` を明示指定しています
 
 ## 提供ツール
 
@@ -145,12 +165,15 @@ Java(Maven)プロジェクトをスキャンし、既知の脆弱性レポート
 
 > **Gradleプロジェクトについて**: 本ツールは**lockfile方式**のみ対応です(ビルド実行方式は build.gradle の任意コード実行を伴うため、セキュリティ上の理由から採用していません)。`gradle.lockfile` が無い場合は `./gradlew dependencies --write-locks` で生成してください(依存ロック未設定の場合は `build.gradle` に `dependencyLocking { lockAllConfigurations() }` の追加が必要です)。
 
+> **スキャン範囲**: ディレクトリを指定すると、配下の `pom.xml` / `gradle.lockfile` / `buildscript-gradle.lockfile` を深さに関係なく検出し、**検出したファイルだけ**をスキャンします(応答の `manifests` がそのままスキャン範囲です)。同じディレクトリにある `package-lock.json` や `requirements.txt` などJava以外のファイルはスキャンしません。`.git`、`node_modules`、`target`、`build`、`.idea`、`.vscode` とシンボリックリンクは探索しません。探索するエントリが20万件、またはマニフェストが1,000件を超える場合は、結果を黙って省略せず `manifest_search_limit_exceeded` を返します。`pom.xml` などのマニフェストを直接指定した場合は、ディレクトリを探索せず**そのファイルだけ**をスキャンします(上限に達した場合の回避手段としても使えます)。
+
 **出力(成功時)**
 
 ```json
 {
   "project_dir": "/path/to/project",
   "manifests": ["pom.xml"],
+  "dependency_resolution": { "transitive_resolution": "enabled" },
   "source_files": ["/path/to/project/pom.xml"],
   "vulnerable_package_count": 4,
   "vulnerability_count": 14,
@@ -249,6 +272,7 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 {
   "project_dir": "/path/to/project",
   "manifests": ["pom.xml"],
+  "dependency_resolution": { "transitive_resolution": "enabled" },
   "vulnerable_package_count": 4,
   "unfixed_vulnerability_count": 1,
   "suggestions": [
@@ -272,6 +296,7 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 - MavenのOSV `ECOSYSTEM` 範囲(`introduced` / `fixed` / `last_affected` / 上限なし)を照合します。`versions` に明示された影響も確認します。範囲欠落・不正・未対応形式・`limit` による不完全な情報では安全と推定せず、候補を検証できなければ `recommended_upgrade: null`、`verification: "no_verified_candidate"` を返します。
 - 推奨時は `verification: "verified"`、CVEごとの `recommended_status` は `affected` / `not_affected` / `unknown` です。推奨保留時は `not_evaluated` になります。`per_cve_detail.fixed_in` は各CVE単独の候補であり、最終推奨先の判定は `recommended_status` を参照してください。
 - 現在より新しい修正版候補がないCVEは `tier: "unfixed"` として推奨の修正対象から除外します(情報欠落を含む場合があります)。除外したCVEも推奨先で判定し、その状態を表示します。全CVEがunfixedの場合も `recommended_upgrade` は `null` です。
+- 修正版の推奨はMavenのみ対応です。Maven以外のパッケージは `verification: "unsupported_ecosystem"`、CVEごとの `tier: "unsupported"` を返し、`unfixed` には数えません(修正版の有無は判定していないため。修正版は `explain_vulnerability` で確認できます)。
 
 ### `explain_vulnerability`
 
@@ -295,7 +320,7 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 {
   "error": {
     "kind": "no_manifest_found",
-    "message": "対応マニフェスト(pom.xml / gradle.lockfile)が見つかりません(深さ3まで探索): /path/to/project"
+    "message": "対応マニフェスト(pom.xml / gradle.lockfile)が見つかりません: /path/to/project"
   }
 }
 ```
@@ -305,6 +330,7 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 | `binary_not_found` | OSV-Scannerが見つからない(インストール案内をmessageに含む) |
 | `project_not_found` | 指定パスが存在しない・ディレクトリ/pom.xmlでない |
 | `no_manifest_found` | 対応マニフェスト(pom.xml / gradle.lockfile)が見つからない |
+| `manifest_search_limit_exceeded` | マニフェスト探索が上限(20万エントリ・1,000マニフェスト)に達した。より狭いディレクトリかマニフェストを直接指定する |
 | `binary_download_failed` | バイナリのダウンロード失敗(未対応プラットフォーム含む) |
 | `binary_checksum_mismatch` | ダウンロードしたバイナリのチェックサム不一致(改ざん/破損の可能性) |
 | `gradle_lockfile_missing` | Gradleプロジェクトだがgradle.lockfileが無い(生成手順をmessageで案内) |
@@ -326,9 +352,10 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 
 - **サプライチェーン対策**: バイナリの自動ダウンロードは公式GitHub Releasesに限定し、バージョンをピン留め。**パッケージに埋め込まれたSHA256チェックサム**で検証します(配布元のSHA256SUMSファイルは信用しないため、リリース側が改ざんされても検出可能)。検証合格まで実行権限を与えず、キャッシュ済みバイナリも使用のたびに再検証します。`OSV_MCP_PREFER_DOWNLOAD=1` でPATH上の未検証バイナリを使わない運用も選べます
 - **コマンドインジェクション対策**: シェルを経由しない `spawn` + 引数配列で実行。OSV-Scannerへの引数は固定リストのみで、可変部は検証済み絶対パス1つだけ
-- **パストラバーサル対策**: 入力パスは `realpath` でシンボリックリンク解決後に境界チェック。pom.xml探索ではシンボリックリンクを辿りません
+- **パストラバーサル対策**: 入力パスは `realpath` でシンボリックリンク解決後に境界チェック。pom.xml探索ではシンボリックリンクを辿りません。OSV-Scannerにはディレクトリを渡さず、検出したマニフェストだけを形式を明示して個別に渡します(ディレクトリを渡すと、OSV-Scannerが同じディレクトリの `requirements.txt` も読み、その取り込み指定 `-r ../x.txt` でスキャン範囲の外のファイルを読むため)
 - **DoS対策**: タイムアウト・stdout上限・stderr抜粋上限を設定。スキャン結果は防御的にパースし、形式不正でも例外を投げません。同時実行スキャン数も上限(デフォルト2)を設け、並列リクエストによるプロセスの無制限起動を防ぎます
 - **fail-closedな運用モード**: `OSV_MCP_REQUIRE_ALLOWED_ROOT=1` で、スキャン許可ルート未設定時にサーバーの起動自体を拒否できます
+- **通信先の固定と明示**: osv-scannerの依存解決先は `deps.dev` を明示指定し、スキャン対象のpom.xmlが指定する任意のリポジトリへ接続するモード(`--data-source native`)は使いません(テストで保証)。通信先の一覧と、deps.devへの送信を止める `OSV_MCP_NO_REMOTE_RESOLUTION=1` は[通信先とプライバシー](#通信先とプライバシー)を参照
 - **情報漏えい対策**: 想定外の例外はスタックトレース等を含めず `internal_error` に丸めます。外部由来のテキスト(脆弱性summary等)は長さ上限付きの「データ」として構造化して返します
 - **プロンプトインジェクション対策**: OSVデータベース由来のテキスト(summary / details / ID等)とOSV-Scannerのstderrは、LLMクライアントへ返す前にサニタイズします。制御文字(ANSIエスケープ含む)・ゼロ幅文字・双方向制御文字(RLO等)・Unicodeタグ文字(不可視のテキスト密輸)・行区切り(U+2028/2029)を除去し、NFC正規化を適用。外部データの読み取りアクセサを単一のサニタイズ境界にすることで適用漏れを防いでいます
 

package/dist/index.js

@@ -9,6 +9,7 @@
  * - OSV_MCP_MAX_CONCURRENT_SCANS: 同時実行スキャン数の上限(デフォルト2)
  * - OSV_MCP_AUTO_DOWNLOAD: 0/false指定時、バイナリの自動ダウンロードを無効化
  * - OSV_MCP_PREFER_DOWNLOAD: 1/true指定時、PATH上のバイナリを使わず検証済み自動ダウンロードを優先
+ * - OSV_MCP_NO_REMOTE_RESOLUTION: 1/true指定時、pom.xmlの推移的依存をdeps.devで解決しない
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -34,13 +35,14 @@ if (startupWarning !== null) {
 // NOTE: リリース時はpackage.jsonのversionと同じ値に更新すること
 const server = new McpServer({
     name: "osv-scanner-mcp",
-    version: "0.3.2",
+    version: "0.3.4",
 });
 server.registerTool("scan_java_project", {
     title: "Javaプロジェクトの脆弱性スキャン",
     description: "Java(Maven)プロジェクトをGoogle OSV-Scannerでスキャンし、依存ライブラリの既知の脆弱性(CVE/GHSA)を深刻度順のJSONレポートで返す。" +
         "レポートにはパッケージごとの脆弱性一覧(CVSSスコア・5段階深刻度・修正版バージョン)とサマリ集計が含まれる。" +
-        "Maven(pom.xml)とGradle(gradle.lockfile)に対応。",
+        "Maven(pom.xml)とGradle(gradle.lockfile)に対応。" +
+        "dependency_resolution.warningがある場合は推移的依存がスキャン対象外のため、検出0件でも安全とは判断しないこと。",
     inputSchema: {
         project_path: z
             .string()
@@ -55,7 +57,8 @@ server.registerTool("suggest_fix", {
         "(same_minor: 同一major.minor系統内 → major_internal: 同一メジャー内 → cross_major: メジャーアップグレード)で選定し、" +
         "推奨バージョン・アップグレード距離(upgrade_tier)・CVEごとの修正版を返す。" +
         "候補を全修正対象CVEの影響範囲と照合し、情報不足の場合は推奨を保留する。" +
-        "現在より新しい修正版候補のないCVEはunfixedとして別表示し、推奨先での判定も返す。Maven(pom.xml)とGradle(gradle.lockfile)に対応。",
+        "現在より新しい修正版候補のないCVEはunfixedとして別表示し、推奨先での判定も返す。Maven(pom.xml)とGradle(gradle.lockfile)に対応。" +
+        "dependency_resolution.warningがある場合は推移的依存の脆弱性が提案に含まれない。",
     inputSchema: {
         project_path: z
             .string()

package/dist/osv/runner.js

@@ -4,7 +4,10 @@
  * セキュリティ設計(docs/DESIGN_TODO.md):
  * - シェルを経由しない`spawn`+引数配列で実行(コマンドインジェクション対策)
  * - OSV-Scannerへ渡す引数は固定リストのみ。呼び出し側から任意フラグは注入できない
- *   (プロジェクトは検証済みディレクトリ1つ、実体スキャンは列挙済みのJAR/WAR絶対パスだけを渡す)
+ *   (プロジェクトは検出済みマニフェストを`--lockfile <形式>:<絶対パス>`で個別に、
+ *   実体スキャンは列挙済みのJAR/WAR絶対パスだけを渡す)
+ * - プロジェクトにディレクトリ(`-r`)を渡さない。osv-scannerがディレクトリ内の
+ *   requirements.txt等も読み、その`-r ../x.txt`の取り込みでスキャン範囲の外のファイルを読むため
  * - SBOMは検証・サイズ制限済みの専用一時コピー1つだけを渡す
  * - タイムアウトと出力サイズ上限を設ける(ハング・巨大出力によるDoS対策)
  *
@@ -12,6 +15,7 @@
  *   0 = スキャン成功・脆弱性なし / 1 = スキャン成功・脆弱性あり / 128 = 対象パッケージなし
  */
 import { spawn } from "node:child_process";
+import path from "node:path";
 import { ScanToolError } from "../errors.js";
 import { resolveOsvScannerBinary } from "./binaryManager.js";
 import { parseOsvScanOutput } from "./scanReport.js";
@@ -37,8 +41,36 @@ function maxConcurrentScansFromEnv() {
 const DEFAULT_MAX_OUTPUT_BYTES = 32 * 1024 * 1024;
 /** エラー詳細に含めるstderrの上限(外部由来テキストをそのまま膨らませない) */
 const MAX_STDERR_DETAIL_BYTES = 8 * 1024;
-/** OSV-Scannerに渡す固定引数。ここに無いオプションは一切使わない(ホワイトリスト) */
-const FIXED_SCAN_ARGS = ["scan", "source", "-r", "--format", "json"];
+const NO_REMOTE_RESOLUTION_ENV = "OSV_MCP_NO_REMOTE_RESOLUTION";
+function noRemoteResolutionFromEnv() {
+    const value = process.env[NO_REMOTE_RESOLUTION_ENV]?.trim().toLowerCase();
+    return value === "1" || value === "true" || value === "yes";
+}
+/** 外部解決を無効にするか。スキャン引数と応答の表示が食い違わないよう、呼び出し側で一度だけ決める */
+export function isRemoteResolutionDisabled(options = {}) {
+    return options.noRemoteResolution ?? noRemoteResolutionFromEnv();
+}
+/**
+ * OSV-Scannerに渡す固定引数。ここに無いオプションは一切使わない(ホワイトリスト)
+ *
+ * pom.xml/requirements.txtの推移的依存はapi.deps.devで解決される(2.4.0で実機確認)。
+ * `--data-source native` はスキャン対象pom.xmlの<repositories>に書かれた任意のURLへ
+ * 接続するため使わない。既定値の変更に備えてdeps.devを明示する。
+ */
+const FIXED_SCAN_ARGS = ["scan", "source", "--format", "json", "--data-source", "deps.dev"];
+const NO_RESOLVE_ARG = "--no-resolve";
+/** 個別に渡せるマニフェスト。ファイル名をそのまま解析形式として明示する(2.4.0で実機確認) */
+const PROJECT_MANIFEST_FORMATS = new Set(["pom.xml", "gradle.lockfile", "buildscript-gradle.lockfile"]);
+/** 検出済みマニフェストを`--lockfile <形式>:<絶対パス>`の組にする。対象外のパスは渡さない */
+export function buildProjectTargetArgs(manifestPaths) {
+    return manifestPaths.flatMap((manifestPath) => {
+        const format = path.basename(manifestPath);
+        if (!PROJECT_MANIFEST_FORMATS.has(format) || !path.isAbsolute(manifestPath)) {
+            throw new Error(`Unsupported manifest path for project scan: ${manifestPath}`);
+        }
+        return ["--lockfile", `${format}:${manifestPath}`];
+    });
+}
 const FIXED_ARTIFACT_ARGS = [
     "scan", "source", "--format", "json", "--all-packages", "--no-ignore",
     "--experimental-no-default-plugins", "--experimental-plugins", "java/archive",
@@ -48,13 +80,20 @@ const FIXED_SBOM_ARGS = [
     "--experimental-no-default-plugins", "--experimental-plugins", "sbom",
 ];
 const SCAN_ARGS = { project: FIXED_SCAN_ARGS, artifact: FIXED_ARTIFACT_ARGS, sbom: FIXED_SBOM_ARGS };
+/** 外部解決を行うのはマニフェストを読むprojectモードだけ(artifact/sbomはOSV照会のみ) */
+export function buildOsvScanArgs(mode, noRemoteResolution) {
+    const args = [...SCAN_ARGS[mode]];
+    if (mode === "project" && noRemoteResolution)
+        args.push(NO_RESOLVE_ARG);
+    return args;
+}
 const EXIT_NO_VULNS = 0;
 const EXIT_VULNS_FOUND = 1;
 const EXIT_NO_PACKAGES = 128;
-function execOsvScanner(binaryPath, targetPaths, timeoutMs, maxOutputBytes, mode) {
+function execOsvScanner(binaryPath, targetPaths, timeoutMs, maxOutputBytes, scanArgs) {
     return new Promise((resolve, reject) => {
         const child = spawn(binaryPath, [
-            ...SCAN_ARGS[mode], ...targetPaths,
+            ...scanArgs, ...targetPaths,
         ], {
             shell: false,
             stdio: ["ignore", "pipe", "pipe"],
@@ -107,13 +146,16 @@ function execOsvScanner(binaryPath, targetPaths, timeoutMs, maxOutputBytes, mode
     });
 }
 /**
- * projectDirをOSV-Scannerでスキャンし、整形済みレポートを返す。
+ * 検出済みマニフェストだけをOSV-Scannerでスキャンし、整形済みレポートを返す。
  *
- * @param projectDir スキャン対象ディレクトリ。**必ず`detectJavaProject`で検証済みの
- *   絶対パスを渡すこと**(このレイヤーではパス検証を行わない)
+ * @param manifestPaths **`detectJavaProject`が検出したマニフェストの絶対パス**
+ *   (このレイヤーではスキャン範囲の検証を行わない。ディレクトリは渡さない)
  */
-export async function runOsvScan(projectDir, options = {}) {
-    return parseOsvScanOutput(await runScan([projectDir], options, "project"));
+export async function runOsvScan(manifestPaths, options = {}) {
+    if (manifestPaths.length === 0) {
+        throw new ScanToolError("no_manifest_found", "スキャン対象のマニフェストがありません");
+    }
+    return parseOsvScanOutput(await runScan(manifestPaths, options, "project"));
 }
 /** Accept only the exact absolute files enumerated by detectJavaArtifacts. */
 export async function runOsvArtifactScan(artifactPaths, options = {}) {
@@ -141,9 +183,9 @@ async function runScan(targetPaths, options, mode) {
 }
 async function runOsvScanUnguarded(targetPaths, options, mode) {
     const binaryPath = options.binaryPath ?? (await resolveOsvScannerBinary());
-    const result = await execOsvScanner(binaryPath, targetPaths, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES, mode);
+    const result = await execOsvScanner(binaryPath, mode === "project" ? buildProjectTargetArgs(targetPaths) : targetPaths, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES, buildOsvScanArgs(mode, isRemoteResolutionDisabled(options)));
     if (result.exitCode === EXIT_NO_PACKAGES && mode === "project") {
-        throw new ScanToolError("no_packages_found", `OSV-Scannerがスキャン対象のパッケージを検出できませんでした: ${targetPaths[0]}(pom.xmlに依存関係が定義されているか確認してください)`, result.stderr);
+        throw new ScanToolError("no_packages_found", `OSV-Scannerがスキャン対象のパッケージを検出できませんでした(マニフェスト${targetPaths.length}件。pom.xmlに依存関係が定義されているか確認してください)`, result.stderr);
     }
     if (mode !== "project" && result.exitCode === EXIT_NO_PACKAGES && result.stdout.trim() === "") {
         return { results: [] };

package/dist/osv/suggestFix.js

@@ -16,6 +16,32 @@
  */
 import { compareMavenVersions, mavenVersionSeries } from "../utils/mavenVersion.js";
 import { candidateStatus } from "./affectedVersions.js";
+/** バージョン比較・影響範囲の検証が対応済みのエコシステム */
+const SUPPORTED_ECOSYSTEMS = new Set(["Maven"]);
+/**
+ * 未対応エコシステムは推奨を出さず、CVEをunfixedにも数えない。
+ * 修正版の抽出がMaven専用のため、そのまま処理すると修正版のある脆弱性を
+ * 「修正版なし」と誤表示する(v0.3.3で確認した不具合)。
+ */
+function unsupportedEcosystemSuggestion(pkg) {
+    return {
+        package: pkg.name,
+        current_version: pkg.version,
+        ecosystem: pkg.ecosystem,
+        recommended_upgrade: null,
+        upgrade_tier: null,
+        upgrade_note: `${pkg.ecosystem}の修正版推奨には未対応です(修正版の有無は判定していません)。` +
+            "各脆弱性の修正版はexplain_vulnerabilityで確認してください",
+        per_cve_detail: pkg.vulnerabilities.map((vuln) => ({
+            id: vuln.id,
+            cve: vuln.cve,
+            severity: vuln.severity,
+            fixed_in: null,
+            tier: "unsupported",
+        })),
+        verification: "unsupported_ecosystem",
+    };
+}
 function classifyTier(currentSeries, candidate) {
     const candidateSeries = mavenVersionSeries(candidate);
     if (currentSeries === null || candidateSeries === null)
@@ -73,6 +99,8 @@ function buildNote(currentSeries, recommended, tier, fixableCount, unfixedCount)
 }
 /** 1パッケージ分のアップグレード提案を組み立てる。 */
 export function suggestUpgradeForPackage(pkg) {
+    if (!SUPPORTED_ECOSYSTEMS.has(pkg.ecosystem))
+        return unsupportedEcosystemSuggestion(pkg);
     const currentSeries = mavenVersionSeries(pkg.version);
     const details = [];
     let recommended = null;

package/dist/tools/scanJavaProject.js

@@ -2,18 +2,33 @@
  * `scan_java_project`ツールのハンドラ。
  * レスポンス形式(成功/エラー)は`toolResult.ts`参照。
  */
-import { runOsvScan } from "../osv/runner.js";
+import { isRemoteResolutionDisabled, runOsvScan } from "../osv/runner.js";
 import { detectJavaProject } from "../utils/projectDetector.js";
 import { errorResult, jsonResult } from "./toolResult.js";
+const TRANSITIVE_OMITTED_WARNING = "OSV_MCP_NO_REMOTE_RESOLUTIONの設定により、マニフェスト(pom.xml)からの推移的依存の解決を省略しています。" +
+    "lockfile(gradle.lockfile)に記録された依存は対象ですが、pom.xmlに直接記載された依存の先にある推移的依存の脆弱性は含まれません。" +
+    "検出0件でも推移的依存の安全性は確認できていません";
+/**
+ * 推移的依存の解決状態。無効時に「検出0件」を安全と誤読されないよう応答の先頭付近に置く。
+ * マニフェスト一覧の探索深さはosv-scannerの`-r`と一致しないため、一覧からpom.xmlの有無を
+ * 判定せず、無効時は条件付きの警告を常に返す。
+ */
+export function dependencyResolution(noRemoteResolution) {
+    return noRemoteResolution
+        ? { transitive_resolution: "disabled", warning: TRANSITIVE_OMITTED_WARNING }
+        : { transitive_resolution: "enabled" };
+}
 export async function handleScanJavaProject(args, options = {}) {
     try {
         const project = await detectJavaProject(args.project_path, {
             allowedRoot: options.allowedRoot,
         });
-        const report = await runOsvScan(project.projectDir, options);
+        const noRemoteResolution = isRemoteResolutionDisabled(options);
+        const report = await runOsvScan(project.manifestPaths, { ...options, noRemoteResolution });
         return jsonResult({
             project_dir: project.projectDir,
             manifests: project.manifests,
+            dependency_resolution: dependencyResolution(noRemoteResolution),
             ...report,
         });
     }

package/dist/tools/suggestFix.js

@@ -3,21 +3,24 @@
  * scan_java_projectと同じスキャンを実行し、脆弱なパッケージごとの
  * 推奨アップグレードバージョン(3段階Tier)を返す。
  */
-import { runOsvScan } from "../osv/runner.js";
+import { isRemoteResolutionDisabled, runOsvScan } from "../osv/runner.js";
 import { suggestUpgrades } from "../osv/suggestFix.js";
 import { detectJavaProject } from "../utils/projectDetector.js";
+import { dependencyResolution, } from "./scanJavaProject.js";
 import { errorResult, jsonResult } from "./toolResult.js";
 export async function handleSuggestFix(args, options = {}) {
     try {
         const project = await detectJavaProject(args.project_path, {
             allowedRoot: options.allowedRoot,
         });
-        const report = await runOsvScan(project.projectDir, options);
+        const noRemoteResolution = isRemoteResolutionDisabled(options);
+        const report = await runOsvScan(project.manifestPaths, { ...options, noRemoteResolution });
         const suggestions = suggestUpgrades(report.packages);
         const unfixedVulnerabilities = suggestions.reduce((sum, s) => sum + s.per_cve_detail.filter((d) => d.tier === "unfixed").length, 0);
         return jsonResult({
             project_dir: project.projectDir,
             manifests: project.manifests,
+            dependency_resolution: dependencyResolution(noRemoteResolution),
             vulnerable_package_count: suggestions.length,
             unfixed_vulnerability_count: unfixedVulnerabilities,
             suggestions,

package/dist/utils/projectDetector.js

@@ -11,14 +11,18 @@
  * `project_path`はLLM・ユーザー由来の信頼できない入力として扱う:
  * - `realpath`で正規化し、シンボリックリンクを解決した実体パスで判定する
  * - `allowedRoot`指定時は、解決後のパスがその配下にあることを検証する(パストラバーサル対策)
- * - マニフェスト探索は深さ・件数に上限を設け、シンボリックリンクのディレクトリは辿らない
+ * - マニフェスト探索はエントリ数・件数・深さに上限を設け、シンボリックリンクのディレクトリは辿らない
+ *
+ * 検出したマニフェストが、そのままOSV-Scannerのスキャン範囲になる(ディレクトリは渡さない)。
+ * そのため探索を深さで打ち切らず(Javaのソースツリーは深い)、上限に達した場合は
+ * 結果を黙って欠落させずにエラーにする。
  */
 import { readdir, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { ScanToolError } from "../errors.js";
-const DEFAULT_MAX_DEPTH = 3;
-/** 探索を打ち切るマニフェスト件数の上限(巨大モノレポでの暴走防止) */
-const MAX_MANIFESTS = 100;
+const DEFAULT_MAX_DEPTH = 64;
+const DEFAULT_MAX_ENTRIES = 200_000;
+const DEFAULT_MAX_MANIFESTS = 1_000;
 /** ビルド成果物・VCS等、マニフェスト探索でスキップするディレクトリ */
 const SKIPPED_DIRS = new Set([".git", "node_modules", "target", "build", ".idea", ".vscode"]);
 /** OSV-Scannerがスキャンできるマニフェスト(実機確認済み) */
@@ -48,12 +52,19 @@ function assertInsideAllowedRoot(resolvedDir, allowedRootReal) {
         throw new ScanToolError("path_outside_allowed_root", `指定されたパスは許可されたディレクトリ(${allowedRootReal})の外にあります`);
     }
 }
-/** 深さ・件数上限付きでマニフェストを探索する。シンボリックリンクは辿らない。 */
-async function findManifests(rootDir, maxDepth) {
+function searchLimitError(reason) {
+    return new ScanToolError("manifest_search_limit_exceeded", `マニフェスト探索が上限(${reason})に達したため、スキャンを中止しました。` +
+        "結果の欠落を避けるため途中までの結果は返しません。より狭いディレクトリ、またはpom.xml / gradle.lockfileを直接指定してください");
+}
+/** 上限付きでマニフェストを探索する。シンボリックリンクは辿らない。上限到達はエラー。 */
+async function findManifests(rootDir, limits) {
     const manifests = [];
     let gradleBuildFileFound = false;
+    let visited = 0;
     let currentLevel = [rootDir];
-    for (let depth = 1; depth <= maxDepth && currentLevel.length > 0; depth++) {
+    for (let depth = 1; currentLevel.length > 0; depth++) {
+        if (depth > limits.maxDepth)
+            throw searchLimitError(`深さ${limits.maxDepth}`);
         const nextLevel = [];
         for (const dir of currentLevel) {
             let entries;
@@ -64,10 +75,12 @@ async function findManifests(rootDir, maxDepth) {
                 continue; // 読めないディレクトリはスキップ(権限不足等)
             }
             for (const entry of entries) {
+                if (++visited > limits.maxEntries)
+                    throw searchLimitError(`${limits.maxEntries}エントリ`);
                 if (entry.isFile() && MANIFEST_FILENAMES.has(entry.name)) {
+                    if (manifests.length >= limits.maxManifests)
+                        throw searchLimitError(`マニフェスト${limits.maxManifests}件`);
                     manifests.push(path.relative(rootDir, path.join(dir, entry.name)));
-                    if (manifests.length >= MAX_MANIFESTS)
-                        return { manifests, gradleBuildFileFound };
                 }
                 else if (entry.isFile() && GRADLE_BUILD_FILENAMES.has(entry.name)) {
                     gradleBuildFileFound = true;
@@ -93,14 +106,21 @@ export async function detectJavaProject(inputPath, options = {}) {
     }
     const resolved = await resolveExistingPath(inputPath);
     const stats = await stat(resolved);
+    // マニフェストの直接指定は、そのファイル1件だけをスキャン範囲にする。
+    // 親ディレクトリを探索しないため、探索上限エラーの回避手段として使える
+    if (stats.isFile() && MANIFEST_FILENAMES.has(path.basename(resolved))) {
+        const projectDir = path.dirname(resolved);
+        if (options.allowedRoot !== undefined) {
+            assertInsideAllowedRoot(projectDir, await resolveExistingPath(options.allowedRoot));
+        }
+        return { projectDir, manifests: [path.basename(resolved)], manifestPaths: [resolved] };
+    }
     let projectDir;
     if (stats.isDirectory()) {
         projectDir = resolved;
     }
-    else if (stats.isFile() &&
-        (MANIFEST_FILENAMES.has(path.basename(resolved)) ||
-            GRADLE_BUILD_FILENAMES.has(path.basename(resolved)))) {
-        // build.gradle等の直接指定も受け付け、ディレクトリとして解決する
+    else if (stats.isFile() && GRADLE_BUILD_FILENAMES.has(path.basename(resolved))) {
+        // build.gradle等の直接指定は、lockfileを探すためディレクトリとして解決する
         // (lockfileが無ければ後段でgradle_lockfile_missingの案内になる)
         projectDir = path.dirname(resolved);
     }
@@ -110,13 +130,20 @@ export async function detectJavaProject(inputPath, options = {}) {
     if (options.allowedRoot !== undefined) {
         assertInsideAllowedRoot(projectDir, await resolveExistingPath(options.allowedRoot));
     }
-    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
-    const { manifests, gradleBuildFileFound } = await findManifests(projectDir, maxDepth);
+    const { manifests, gradleBuildFileFound } = await findManifests(projectDir, {
+        maxDepth: options.maxDepth ?? DEFAULT_MAX_DEPTH,
+        maxEntries: options.maxEntries ?? DEFAULT_MAX_ENTRIES,
+        maxManifests: options.maxManifests ?? DEFAULT_MAX_MANIFESTS,
+    });
     if (manifests.length === 0) {
         if (gradleBuildFileFound) {
             throw new ScanToolError("gradle_lockfile_missing", GRADLE_LOCKFILE_GUIDANCE);
         }
-        throw new ScanToolError("no_manifest_found", `対応マニフェスト(pom.xml / gradle.lockfile)が見つかりません(深さ${maxDepth}まで探索): ${projectDir}`);
+        throw new ScanToolError("no_manifest_found", `対応マニフェスト(pom.xml / gradle.lockfile)が見つかりません: ${projectDir}`);
     }
-    return { projectDir, manifests };
+    return {
+        projectDir,
+        manifests,
+        manifestPaths: manifests.map((manifest) => path.join(projectDir, manifest)),
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osv-scanner-mcp",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "MCP server that wraps Google's OSV-Scanner to scan Java projects for known vulnerabilities",
   "type": "module",
   "license": "Apache-2.0",
@@ -50,8 +50,5 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
-  },
-  "overrides": {
-    "@hono/node-server": "^2.0.11"
   }
 }