osv-scanner-mcp 0.3.1 → 0.3.3

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` を明示指定しています
 
 ## 提供ツール
 
@@ -151,6 +171,7 @@ Java(Maven)プロジェクトをスキャンし、既知の脆弱性レポート
 {
   "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 +270,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": [
@@ -329,6 +351,7 @@ OSV-Scanner 2.4.0の `java/archive` プラグインを使用し、ネストJAR
 - **パストラバーサル対策**: 入力パスは `realpath` でシンボリックリンク解決後に境界チェック。pom.xml探索ではシンボリックリンクを辿りません
 - **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.1",
+    version: "0.3.3",
 });
 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

@@ -37,8 +37,24 @@ 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", "-r", "--format", "json", "--data-source", "deps.dev"];
+const NO_RESOLVE_ARG = "--no-resolve";
 const FIXED_ARTIFACT_ARGS = [
     "scan", "source", "--format", "json", "--all-packages", "--no-ignore",
     "--experimental-no-default-plugins", "--experimental-plugins", "java/archive",
@@ -48,13 +64,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"],
@@ -141,7 +164,7 @@ 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, 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);
     }

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.projectDir, { ...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.projectDir, { ...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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osv-scanner-mcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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"
   }
 }