अपडेट पर वापस जाएँ
New releaseAug 21, 2026

mcp-stdio-shellguard v0.1.2

MCP stdio सर्वरों के लिए गहन सुरक्षा बंडल: ड्रॉप-इन guardExec/guardSpawn रैपर, AST ऑडिट CLI, संदर्भ MCP सर्वर। Ox-Security 200k-server stdio-RCE श्रेणी (LiteLLM CVE-2025-69256) को समाप्त करता है। MIT, TypeScript, Node >= 20।

साझा करें

StudioMeyer MCP Stack का हिस्सा — Mallorca 🌴 में निर्मित · ⭐ अगर आप इसका उपयोग करते हैं

mcp-stdio-shellguard

npm version npm downloads License Last commit GitHub stars

MCP stdio सर्वर के लिए defense-in-depth बंडल। `child_process.exec/spawn` को allowlist + sandbox + replay-detection के साथ रैप करता है, साथ ही एक AST ऑडिट CLI (`mcp-shellguard-audit`) प्रदान करता है जो MCP सर्वर स्रोतों में असैनिटाइज़्ड शेल कॉल्स को स्कैन करता है। यह Ox-Security MCP stdio-RCE श्रेणी (200k कमज़ोर सर्वर, मई 2026 प्रकटीकरण) को बंद करता है।
  • MCP spec: 2025-06-18
  • SDK: @modelcontextprotocol/sdk ^1.29.0
  • Node: >= 20
  • License: MIT
  • Author: Matthias Meyer (StudioMeyer)

Install

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 ओवरराइड किसी इंस्टॉल किए गए पैकेज के निर्भरता ट्री को सीमित नहीं करता; शामिल क्लोज़र उपभोक्ताओं तक जाँचे गए संस्करणों को पहुँचाता है। बंडल तैयारी @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 को ट्रैवर्स करता है, 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परिवर्तनकारीएक टूल नाम को executable + args regex के साथ पंजीकृत करें। पंजीकरण के बिना डिफ़ॉल्ट-डिनाई लागू होता है।
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 s1 MB256 KB32हाँ (cpu/memory)
standard (डिफ़ॉल्ट)30 s10 MB1 MB256हाँ
permissive5 min100 MB10 MB1024नहीं

कॉलर प्रति कॉल timeoutMs / fdBudget के माध्यम से कड़ा कर सकता है। कॉलर प्रोफ़ाइल से आगे नहीं बढ़ा सकता।

ट्रस्ट टियर

टियरशर्त
LOWटूल पंजीकृत नहीं (डिफ़ॉल्ट-डिनाई)
MEDIUMपंजीकृत लेकिन argsPatterns खाली (कोई भी args अनुमत)
HIGHargsPatterns सेट लेकिन सैंडबॉक्स या रीप्ले ट्रैकर निष्क्रिय
CRITICALargsPatterns + सैंडबॉक्स + रीप्ले सभी सक्रिय

Lift LOW → CRITICAL को टूल रजिस्टर करके + argsPatterns सेट करके + guardExec/guardSpawn के माध्यम से चलाकर (जो हमेशा sandbox + replay सक्रिय करते हैं)।

लाइब्रेरी क्विकस्टार्ट

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 नियम)

श्रेणियाँ