osv-scanner-mcp 0.1.2 → 0.1.4

package/README.md

@@ -22,6 +22,7 @@ Google製 [OSV-Scanner](https://github.com/google/osv-scanner) をラップす
 - [OSV-Scanner](https://google.github.io/osv-scanner/) バイナリ — **手動インストールは不要です**。見つからない場合、公式GitHub Releasesからピン留めバージョンを自動ダウンロードし、パッケージに埋め込まれたSHA256チェックサムで検証してから使用します(`~/.cache/osv-scanner-mcp/` にキャッシュ)
   - 手動インストール済みのバイナリ(PATH上または `OSV_SCANNER_PATH` 指定)があればそちらを優先します
   - 自動ダウンロードを無効化する場合は `OSV_MCP_AUTO_DOWNLOAD=0`
+  - PATH上のバイナリを使わず常に検証済み自動ダウンロードを使う場合は `OSV_MCP_PREFER_DOWNLOAD=1`(運用環境向け)
 - スキャン時(OSV-Scanner経由)および `explain_vulnerability` 実行時に `api.osv.dev` へのネットワークアクセスが発生します(照会先はOSVデータベースのみ)
 
 ## セットアップ
@@ -119,9 +120,15 @@ npm run build
 | `OSV_MCP_REQUIRE_ALLOWED_ROOT` | `1` または `true` 指定時、`OSV_MCP_ALLOWED_ROOT` が未設定ならサーバーの起動自体を拒否します(運用環境向けのfail-closedモード) |
 | `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_ALLOWED_ROOT` は未設定でも動作しますが、その場合は任意の絶対パスをスキャンできてしまいます。悪意ある指示(プロンプトインジェクション)経由で意図しないディレクトリをスキャンさせられる経路を塞ぐため、プロジェクト置き場のルート(例: `~/projects`)を設定しておくことを推奨します。各クライアントの設定で `"env": {"OSV_MCP_ALLOWED_ROOT": "/Users/you/projects"}` のように渡せます(Codex CLIのTOMLでは `[mcp_servers.osv-scanner.env]` セクション)。
 
+> **本番運用の推奨構成**: 共有サーバーやCI等の運用環境では、次の3つをセットで設定してください。
+> - `OSV_MCP_ALLOWED_ROOT=/スキャン対象のルート` — スキャン範囲の境界を固定
+> - `OSV_MCP_REQUIRE_ALLOWED_ROOT=1` — 境界未設定なら起動を拒否(fail-closed)
+> - `OSV_SCANNER_PATH=/管理者所有の絶対パス` または `OSV_MCP_PREFER_DOWNLOAD=1` — PATH解決に依存せず、実行するバイナリを固定
+
 ## 提供ツール
 
 ### `scan_java_project`
@@ -261,7 +268,7 @@ Java(Maven)プロジェクトをスキャンし、既知の脆弱性レポート
 
 脆弱性診断ツール自体が攻撃経路にならないよう、以下を実装しています。
 
-- **サプライチェーン対策**: バイナリの自動ダウンロードは公式GitHub Releasesに限定し、バージョンをピン留め。**パッケージに埋め込まれたSHA256チェックサム**で検証します(配布元のSHA256SUMSファイルは信用しないため、リリース側が改ざんされても検出可能)。検証合格まで実行権限を与えず、キャッシュ済みバイナリも使用のたびに再検証します
+- **サプライチェーン対策**: バイナリの自動ダウンロードは公式GitHub Releasesに限定し、バージョンをピン留め。**パッケージに埋め込まれたSHA256チェックサム**で検証します(配布元のSHA256SUMSファイルは信用しないため、リリース側が改ざんされても検出可能)。検証合格まで実行権限を与えず、キャッシュ済みバイナリも使用のたびに再検証します。`OSV_MCP_PREFER_DOWNLOAD=1` でPATH上の未検証バイナリを使わない運用も選べます
 - **コマンドインジェクション対策**: シェルを経由しない `spawn` + 引数配列で実行。OSV-Scannerへの引数は固定リストのみで、可変部は検証済み絶対パス1つだけ
 - **パストラバーサル対策**: 入力パスは `realpath` でシンボリックリンク解決後に境界チェック。pom.xml探索ではシンボリックリンクを辿りません
 - **DoS対策**: タイムアウト・stdout上限・stderr抜粋上限を設定。スキャン結果は防御的にパースし、形式不正でも例外を投げません。同時実行スキャン数も上限(デフォルト2)を設け、並列リクエストによるプロセスの無制限起動を防ぎます

package/dist/index.js

@@ -7,6 +7,8 @@
  * - OSV_MCP_ALLOWED_ROOT: 指定時、このディレクトリ配下以外のスキャンを拒否する(設定を推奨)
  * - OSV_MCP_REQUIRE_ALLOWED_ROOT: 1/true指定時、OSV_MCP_ALLOWED_ROOT未設定なら起動を拒否する
  * - OSV_MCP_MAX_CONCURRENT_SCANS: 同時実行スキャン数の上限(デフォルト2)
+ * - OSV_MCP_AUTO_DOWNLOAD: 0/false指定時、バイナリの自動ダウンロードを無効化
+ * - OSV_MCP_PREFER_DOWNLOAD: 1/true指定時、PATH上のバイナリを使わず検証済み自動ダウンロードを優先
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -30,7 +32,7 @@ if (startupWarning !== null) {
 // NOTE: リリース時はpackage.jsonのversionと同じ値に更新すること
 const server = new McpServer({
     name: "osv-scanner-mcp",
-    version: "0.1.2",
+    version: "0.1.4",
 });
 server.registerTool("scan_java_project", {
     title: "Javaプロジェクトの脆弱性スキャン",

package/dist/osv/binaryManager.js

@@ -52,23 +52,34 @@ export function installGuidance(env = process.env) {
     ].join("\n");
 }
 export const AUTO_DOWNLOAD_ENV = "OSV_MCP_AUTO_DOWNLOAD";
+export const PREFER_DOWNLOAD_ENV = "OSV_MCP_PREFER_DOWNLOAD";
 function isAutoDownloadEnabled(env) {
     const value = env[AUTO_DOWNLOAD_ENV]?.trim().toLowerCase();
     return value !== "0" && value !== "false";
 }
+function isPreferDownloadEnabled(env) {
+    const value = env[PREFER_DOWNLOAD_ENV]?.trim().toLowerCase();
+    return value === "1" || value === "true" || value === "yes";
+}
 /**
  * バイナリのパスを解決する。
  * 探索順: OSV_SCANNER_PATH(明示指定時はダウンロードにフォールバックしない)
  * → PATH → 自動ダウンロード(チェックサム検証付き、OSV_MCP_AUTO_DOWNLOAD=0で無効化)。
+ * OSV_MCP_PREFER_DOWNLOAD=1 の場合はPATH探索をスキップし、チェックサム検証済みの
+ * 自動ダウンロードを優先する(PATH汚染による偽バイナリ実行の防止。明示指定は引き続き最優先)。
  * どれも不可なら案内メッセージ付きのScanToolErrorを投げる。
  */
 export async function resolveOsvScannerBinary(env = process.env, options = {}) {
-    const binary = await findOsvScannerBinary(env);
-    if (binary !== null) {
-        return binary;
-    }
     const explicit = env[OSV_SCANNER_PATH_ENV];
     const explicitlySpecified = explicit !== undefined && explicit.trim() !== "";
+    // PATH上のバイナリはチェックサム検証を経ていないため、運用ではスキップ可能にする
+    const skipPathLookup = !explicitlySpecified && isPreferDownloadEnabled(env);
+    if (!skipPathLookup) {
+        const binary = await findOsvScannerBinary(env);
+        if (binary !== null) {
+            return binary;
+        }
+    }
     // 明示指定が無効な場合は、意図しないバイナリの使用を避けるためダウンロードしない
     if (!explicitlySpecified && isAutoDownloadEnabled(env)) {
         const download = options.downloadFn ??

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osv-scanner-mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP server that wraps Google's OSV-Scanner to scan Java projects for known vulnerabilities",
   "type": "module",
   "license": "Apache-2.0",
@@ -44,7 +44,7 @@
   "devDependencies": {
     "@types/node": "^26.1.0",
     "@vitest/coverage-v8": "^4.1.9",
-    "typescript": "^6.0.3",
+    "typescript": "^7.0.2",
     "vitest": "^4.1.9"
   },
   "dependencies": {