Kitsune 脆弱性研究 MCP

このローカル MCP サーバーは、脆弱性インテリジェンス、研究範囲、スキャナー結果、証拠レシート、Bugcrowd VRT 評価、およびレポート草案を 1 つの SQLite 台帳に保持します。

これは、認可された防御研究のために構築されています。ターゲットをスキャンしたり、エクスプロイトを実行したり、シェルコマンドを実行したり、レポートを送信したり、開示を公開したりしません。

データソース

サーバーは固定アダプターを使用します。呼び出し元が別のオリジンを提供することはできません。

CVE.org が正規のレコードです。NVD はエンリッチメントと最近のレコードの発見のためのものです。KEV と EPSS は別個のシグナルです。VRT は技術的なベースラインであり、認可や保証された報奨金評価ではありません。

Related MCP server: MoonMCP

要件

• Node.js 24 以降

• npm 10 以降

• SARIF または証拠ファイルをインポートする場合は絶対インポートルートが必要

公開フィードに API キーは必要ありません。NVD_API_KEY はオプションで、NVD にのみ送信されます。

インストールと確認

npm install
npm test
npm run check
npm run lint
npm run build

ソースは MIT ライセンスで提供されています。パッケージは npm に公開されていません。

MCP クライアント設定

最初にビルドし、次にクライアントをコンパイル済みの stdio エントリポイントに指定します。

{
  "mcpServers": {
    "kitsune-vuln-research": {
      "command": "node",
      "args": [
        "--disable-warning=ExperimentalWarning",
        "C:\\path\\to\\kitsune-vuln-research-mcp\\dist\\index.js"
      ],
      "env": {
        "VULN_IMPORT_ROOTS": "C:\\absolute\\path\\to\\scanner-output",
        "VULN_LOG_LEVEL": "warn"
      }
    }
  }
}

ライセンス

MIT。 LICENSE を参照してください。

組み込みの Node SQLite モジュールは、Node 24 でも ExperimentalWarning を表示します。この限定的なコマンドラインフラグは、他の警告クラスを抑制せずに、その警告を MCP の stderr から除外します。

設定

実行時状態は VULN_DATA_DIR の下に保持されます。

vuln-research.sqlite
cases/
  <case-id>/
    evidence/
    exports/

SQLite は外部キー、WAL モード、準備済みステートメント、および追記専用のイベントレシートを使用します。ソースペイロードと証拠は SHA-256 でハッシュ化されます。

インテリジェンスツール

候補の順序付けは研究の優先順位です。CVSS、VRT、再現された影響、またはプログラムルールに代わるものではありません。

研究ツール

ここでスコープを登録しても許可は作成されません。authorization_ref は実際の報奨金概要、契約、チケット、またはラボの認可を指している必要があります。

通常のワークフロー

1. VULN_IMPORT_ROOTS をスキャナー出力ディレクトリに設定します。

2. 最近の CVE、KEV、EPSS、および VRT を更新します。

3. 実際のプログラムのスコープと有効期間を登録します。

4. 正確なターゲットと許可されたメソッドに対してケースを作成します。

5. この MCP の外部で、承認されたスキャナー（Semgrep、CodeQL、Trivy、Grype など）を実行します。

6. その SARIF 出力をインポートし、再現証拠を記録します。

7. 末端の VRT パスを選択し、実際の影響を記録します。

8. 人間によるレビューのためにローカル草案をエクスポートします。

スキャナーメッセージとアドバイザリテキストは信頼できないデータとして扱われます。スコープ、ツール選択、SQL、パス、またはレポート構造を変更することはできません。

インポートセキュリティ

• インポートルートは絶対パスであり、明示的に設定する必要があります。

• 正規パスは許可されたルート内に収まっている必要があります。

• シンボリックリンクのインポート、Windows デバイスパス、代替データストリームは拒否されます。

• ファイルはデフォルトで 25 MiB に制限されています。

• 保存された証拠名はサーバーによって生成されます。

• 重複する証拠と SARIF 結果は、ハッシュまたは安定したフィンガープリントによって識別されます。

古いフィードとオフライン作業

キャッシュされたインテリジェンスを使用する前に、vuln_get_source_status を呼び出してください。NVD、KEV、EPSS、および VRT は 24 時間後に古くなります。正規の CVE および OSV クエリ状態は 7 日後に古くなります。

ソースが利用できない場合、最後の良好なキャッシュは読み取り可能なままです。セッションでネットワークリクエストを行わない場合は、VULN_OFFLINE=true を設定します。

テスト

テストスイートはデフォルトで記録されたフィクスチャを使用します。スキーマ、ソース制限、オリジン分離、スコープマッチング、パス包含、SARIF プロンプトインジェクション文字列、証拠ハッシュ化、VRT 評価、レポートエスケープ、MCP 検出、および再起動永続性をカバーします。

evaluation.xml には、tests/fixtures の下の固定された 2026 フィクスチャに基づく、10 個の安定した読み取り専用の質問が含まれています。

評価を実行する前に、それらのフィクスチャをビルドし、新しい絶対データディレクトリにシードします。

npm run seed:evaluation -- C:\absolute\unused\evaluation-data

シーダーは既存のデータベースへの上書きを拒否します。評価サーバーを起動するときは、VULN_DATA_DIR をそのディレクトリに指定します。