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。

查看仓库
6116天前尚未审核

StudioMeyer MCP Stack 的一部分 — 在馬略卡島打造 🌴 · 如果你覺得有用,請給個 ⭐

mcp-stdio-shellguard

npm version npm downloads License Last commit GitHub stars

為 MCP stdio 伺服器提供的縱深防禦套件。以允許清單 + 沙箱 + 重放偵測包裝 `child_process.exec/spawn`,並附帶一個 AST 稽核 CLI(`mcp-shellguard-audit`),可掃描 MCP 伺服器原始碼中未經淨化的 shell 呼叫。封堵 Ox-Security MCP stdio-RCE 類漏洞(20 萬台易受攻擊的伺服器,2026 年 5 月揭露)。
  • 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(十进制 MB)。捆绑会增加下载量和磁盘占用;对所含依赖进行安全更新需要更新包归档。

维护时,请从仓库检出目录运行 npm ci 和 npm run test:consumer。npm pack 会自动运行 prepack:它会构建包并准备所声明的捆绑包。使用方检查会打包两次,验证字节完全一致,在全新项目中安装实际归档,检查 npm ls 和两项依赖审计,并实际运行已安装的 CLI 或运行时。在分发新归档之前,请结合锁定的捆绑包和许可证证明审查依赖更新。归档中的 dist/bundled-dependencies.json 记录了捆绑包和清单调整。

它为你提供什么

三个层次,可按需逐项启用:

  1. 库 API — 可直接替换的 guardExec / guardSpawn,从你自己的 MCP 服务器中调用。默认拒绝的允许列表、沙箱配置文件、重放窗口。
  2. 审计 CLI — mcp-shellguard-audit scan <path> 遍历 AST,报告 12 种反模式,从 LOW(no timeout)到 CRITICAL(exec(\...${userInput}...`)`)。
  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变更性注册工具名称及其可执行文件 + 参数正则。未注册时适用默认拒绝。
audit_source只读扫描 TS/JS 路径以查找 shell 注入反模式。返回 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 为空(允许任意参数)
HIGH已设置 argsPatterns 但沙箱或重放跟踪器未激活
CRITICALargsPatterns + 沙箱 + 重放全部激活

通过注册该工具 + 设置 argsPatterns + 通过 guardExec/guardSpawn 运行(它们始终会激活沙箱 + 重放),将 LOW 提升至 CRITICAL。

库快速入门

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_bufferLOW未设置 maxBuffer 的 exec
missing_timeoutLOW未设置 timeout 的 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({ shell: "/bin/sh" })或动态 shell 值上触发——而不仅仅是字面量 { shell: true }。对非 child_process 函数使用 promisify、从其他模块解构,以及 { shell: false } 均保持干净(无误报)。

编译指示

  • // shellguard:ignore-next-line — 抑制一条发现项
  • // shellguard:ignore-file — 抑制整个文件(罕见;优先使用逐行抑制)

为什么存在

Ox-Security 披露(2026-05),超过 20 万个 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 — 版权所有 (c) 2026 Matthias Meyer (StudioMeyer)

捆绑依赖在归档中保留其完整的上游许可证文本。包许可证适用于本项目自身的代码;捆绑的第三方包保留其各自的条款。消费者检查会根据来自完整性验证的官方 npm 工件的固定内容哈希,验证每个已批准包版本的完整许可证文件,或其完整的 README 许可证部分。空白和行尾差异可接受;缺失、空或部分法律文本将被拒绝。

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

暂无热门数据。

探索所有工具

浏览我们的工具集合

查看所有工具 →