Skip to content
KitploitKITPLOIT
ツールエクスプロイトブログ
Log in
提出
ツールエクスプロイトブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
mcp-stdio-shellguard — MCP stdio サーバー向け多層防御バンドル: そのまま使える guardExec/guardSpawn ラッパー、AST 監査 CLI、リファレンス MCP サーバー。Ox-Security の 20 万サーバー規模の stdio-RCE クラス(LiteLLM CVE-2025-69256)を解消。MIT ライセンス、TypeScript、Node >= 20。 | Kitploit
ツール/GitHubGitHub/studiomeyer-io/mcp-stdio-shellguard
静的分析脆弱性スキャナーコード分析スクリプトと自動化DevSecOpsユーティリティとフレームワークサプライチェーンセキュリティAPIセキュリティ
GitHub
studiomeyer-io/mcp-stdio-shellguard

mcp-stdio-shellguard

MCP stdio サーバー向け多層防御バンドル: そのまま使える guardExec/guardSpawn ラッパー、AST 監査 CLI、リファレンス MCP サーバー。Ox-Security の 20 万サーバー規模の stdio-RCE クラス(LiteLLM CVE-2025-69256)を解消。MIT ライセンス、TypeScript、Node >= 20。

リポジトリを見る
6117日前未レビュー
共有

StudioMeyer MCP Stack の一部 — マヨルカ島で構築 🌴 · 役に立ったら ⭐ を

mcp-stdio-shellguard

npm version npm downloads License Last commit GitHub stars

MCP stdio サーバー向けの多層防御バンドル。`child_process.exec/spawn` を

許可リスト + サンドボックス + リプレイ検出でラップし、さらに未サニタイズのシェル呼び出しを MCP サーバーのソースからスキャンする AST 監査 CLI(mcp-shellguard-audit)を提供します。 Ox-Security の MCP stdio-RCE クラス(2026年5月公表、20万台の脆弱なサーバー)を封じ込めます。

  • MCP 仕様: 2025-06-18
  • SDK: @modelcontextprotocol/sdk ^1.29.0
  • Node: >= 20
  • ライセンス: MIT
  • 作者: Matthias Meyer (StudioMeyer)

インストール

npm install mcp-stdio-shellguard

または、インストールせずに監査CLIを直接実行します:

npx -y -p mcp-stdio-shellguard mcp-shellguard-audit scan ./src

パッケージの内容とメンテナンス

バージョン 0.1.3 には、以下で説明する依存関係バンドルが含まれています。

このパッケージは、bundledDependencies を通じて @typescript-eslint/typescript-estree に加えて TypeScript および必要なパーサー依存関係のクロージャを同梱しています。ルート専用の npm override は、インストールされたパッケージの依存関係ツリーを制約しません。同梱されたクロージャが、検証済みのバージョンをコンシューマーに引き継ぎます。バンドルの準備では、@typescript-eslint/typescript-estree 8.72.1 と minimatch 11.0.3 を確認し、その後パーサーのマニフェストの依存関係範囲のみを minimatch ^10.2.2 から ^11.0.3 に変更します。サードパーティのソースファイルとパッケージのバージョン番号は変更されません。AST 監査は typescript-estree.parse を直接呼び出し、パーサーの依存関係ツリーを満たすために TypeScript を明示的に含めています。ESLint ランタイムは不要です。

計測されたアーカイブは約 4.92 MB(圧縮)および 26.04 MB(展開後)(10 進 MB)です。バンドル化によりダウンロードとディスク使用量が増加します。同梱された依存関係のセキュリティ更新には、更新されたパッケージアーカイブが必要です。

メンテナンスでは、リポジトリのチェックアウトから npm ci と npm run test:consumer を実行します。npm pack は prepack を自動的に実行します。これによりパッケージがビルドされ、宣言されたバンドルが準備されます。コンシューマーチェックは 2 回パックし、バイトが同一であることを検証し、実際のアーカイブを新しいプロジェクトにインストールし、npm ls と両方の依存関係監査を確認し、インストールされた CLI またはランタイムを実行します。新しいアーカイブを配布する前に、依存関係の更新をロックされたバンドルおよびライセンスの証明とともに確認してください。アーカイブの dist/bundled-dependencies.json には、バンドルとマニフェストの調整内容が記録されています。

提供する機能

3 つのレイヤーを段階的にオプトインできます。

  1. ライブラリ API — 独自の MCP サーバーから呼び出すドロップインの guardExec / guardSpawn。デフォルト拒否の許可リスト、サンドボックスプロファイル、リプレイウィンドウ。
  2. 監査 CLI — mcp-shellguard-audit scan <path> が AST を走査し、LOW(no timeout)から CRITICAL(exec(\...${userInput}...`)`)までの 12 のアンチパターンを報告します。
  3. リファレンス MCP サーバー — mcp-stdio-shellguard-demo が 8 つのツールを公開し、MCP Inspector / Claude Desktop がバンドルを直接操作できるようにします。

ツール(リファレンスサーバー)

ツール種類目的
guard_exec破壊的防御された child_process.exec。args[] ベクター、許可リスト + サンドボックス + リプレイを強制します。stdout、stderr、exitCode、canonicalHash、isReplay、trustTier を返します。
guard_spawn破壊的防御された child_process.spawn。完全なボディの代わりに stdout/stderr の SHA-256 ハッシュを返します。shell:true を厳格に拒否します。
register_allowlist変更ツール名を実行可能ファイル + args 正規表現とともに登録します。登録がない場合はデフォルト拒否が適用されます。
audit_source読み取り専用TS/JS パスをスキャンしてシェルインジェクションのアンチパターンを検出します。AuditFinding[] + サマリーを返します。
audit_report読み取り専用監査結果を markdown / json / SARIF 2.1.0 としてフォーマットします。
replay_check読み取り専用呼び出しの正規 SHA-256 ハッシュを計算し、それがすでにリプレイウィンドウ内にあるかどうかを報告します。
sandbox_status読み取り専用アクティブなサンドボックスプロファイル + 具体的な制限 + cgroup-v2 アクティブフラグを報告します。
trust_tier読み取り専用登録されたツールの LOW/MEDIUM/HIGH/CRITICAL ティアと改善のヒントを導出します。

サンドボックスプロファイル

プロファイルタイムアウト最大 stdout最大 stderrFD 予算cgroup-v2
strict5 秒1 MB256 KB32あり(cpu/memory)
standard(デフォルト)30 秒10 MB1 MB256あり
permissive5 分100 MB10 MB1024なし

呼び出し元は、呼び出しごとに timeoutMs / fdBudget で制限を厳しくできます。呼び出し元はプロファイルを超えて制限を緩めることはできません。

信頼ティア

ティア条件
LOWツールが未登録(デフォルト拒否)
MEDIUM登録済みだが argsPatterns が空(任意の引数を許可)
HIGHargsPatterns が設定されているが、サンドボックスまたはリプレイトラッカーが非アクティブ
CRITICALargsPatterns + サンドボックス + リプレイがすべてアクティブ

LOW → CRITICAL に引き上げるには、ツールを登録し、argsPatterns を設定し、guardExec/guardSpawn 経由で実行します(これらは常にサンドボックスとリプレイを有効化します)。

ライブラリ クイックスタート

import {
  AllowlistRegistry,
  ReplayWindow,
  guardExec,
} from "mcp-stdio-shellguard";

const registry = new AllowlistRegistry();
const replay = new ReplayWindow();

registry.register({
  toolName: "git-log",
  executable: "/usr/bin/git",
  argsPatterns: ["^log$", "^--oneline$", "^-n$", "^\\d+$"],
  sandboxProfile: "strict",
});

const result = await guardExec(
  {
    toolName: "git-log",
    command: "/usr/bin/git",
    args: ["log", "--oneline", "-n", "10"],
  },
  { registry, replay },
);

console.log(result.stdout); // → commit lines
console.log(result.trustTier); // → "CRITICAL"
console.log(result.canonicalHash); // → 64-char SHA-256

監査CLI

mcp-shellguard-audit scan ./src
mcp-shellguard-audit scan ./src --format sarif --output audit.sarif
mcp-shellguard-audit scan ./src --severity-floor HIGH    # CI gate

終了コード:

  • 0 クリーン(下限以上の検出なし)
  • 1 検出あり
  • 2 パース / IO エラー

scanPath または audit_source MCP ツールに渡すカスタム ignoreGlobs は、最大 128 個の文字列を受け付けます。各文字列は 1024 UTF-16 コード単位、およびエスケープされていない開始グループ化文字((、{、[)を最大 16 個までに制限されます。これらの上限を超える入力は、マッチングの前に制御されたエラーを発生させます。

アンチパターンライブラリ(12 ルール)

ID重大度トリガー条件
exec_template_literal_with_inputCRITICALchild_process.exec(\ls ${x}`)`
exec_dynamic_stringCRITICALchild_process.exec(cmd)
exec_sync_dynamic_stringCRITICALchild_process.execSync(cmd)
eval_near_child_processCRITICALeval(...)
function_constructor_near_child_processCRITICALnew Function(...)
spawn_dynamic_file_argsHIGHspawn(bin, userArgs)
exec_file_dynamicHIGHexecFile(bin, ...)
shell_true_optionHIGH{ shell: true }
os_system_equivalentHIGHDeno.run / Bun.spawn
spawn_literal_dynamic_argsMEDIUMspawn('git', userArgs)
unbounded_bufferLOWmaxBuffer なしの exec
missing_timeoutLOWtimeout なしの exec/spawn

スキャナはマッチングの前に 名前を変更された child_process バインディングを解決するため、呼び出しがリテラルの child_process.exec ではなくエイリアスを経由している場合でも、以下の危険なパターンが検出されます:

  • const execAsync = promisify(exec); execAsync(...${x})
  • import cp from "node:child_process"; cp.exec(...${x})
  • const { exec: sh } = require("child_process"); sh(...${x})
  • import { exec as run } from "node:child_process"; run(...)

同期バリアント(spawnSync、execFileSync)は非同期のルールを共有し、shell_true_option はリテラルの { shell: true } だけでなく、文字列シェル({ shell: "/bin/sh" })や動的なシェル値でも発火します。child_process 以外の関数に対する promisify、別モジュールからの分割代入、および { shell: false } はクリーンなままです(誤検出なし)。

プラグマ

  • // shellguard:ignore-next-line — 1 件の検出を抑制
  • // shellguard:ignore-file — ファイル全体を抑制(まれ。行単位を推奨)

これが存在する理由

Ox-Security は(2026-05 に)200k 以上の MCP stdio サーバーが、LLM ツール引数から直接ユーザー入力を運ぶテンプレートリテラルで child_process.exec をラップしていることを公表しました。LiteLLM v1.83.6 がその代表例でした(CVE は 1.83.7 で修正済み)。このバンドルは防御的セキュリティの対抗策です。すなわち、このクラスを封じ込めるドロップインのガード + スキャナです。AWS Linux の seccomp と Chromium サンドボックスの階層に着想を得ています。

関連項目

  • HOOK_RECIPES.md — 危険なツール呼び出しを自動ブロックする Claude Code フックレシピ
  • CHANGELOG.md — リリース履歴
  • Ox-Security MCP 監査: https://venturebeat.com/security/200000-mcp-stdio-servers/
  • LiteLLM CVE-2026-XXXX: https://github.com/BerriAI/litellm/security/advisories

ライセンス

MIT — Copyright (c) 2026 Matthias Meyer (StudioMeyer)

ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

まだ人気データがありません。

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →