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 🌴 में निर्मित · ⭐ अगर आप इसका उपयोग करते हैं
@modelcontextprotocol/sdk ^1.29.0npm 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 बंडल और मैनिफ़ेस्ट समायोजनों को रिकॉर्ड करती है।
तीन परतें, टुकड़ों में ऑप्ट-इन:
guardExec / guardSpawn जिन्हें आप अपने
स्वयं के MCP सर्वर से कॉल करते हैं। डिफ़ॉल्ट-डिनाई अनुमति-सूची, सैंडबॉक्स प्रोफ़ाइल, रीप्ले विंडो।mcp-shellguard-audit scan <path> AST को ट्रैवर्स करता है, LOW (no timeout) से CRITICAL (exec(\...${userInput}...`)`) तक 12 एंटी-पैटर्न रिपोर्ट करता है।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 | अधिकतम stderr | FD बजट | cgroup-v2 |
|---|---|---|---|---|---|
strict | 5 s | 1 MB | 256 KB | 32 | हाँ (cpu/memory) |
standard (डिफ़ॉल्ट) | 30 s | 10 MB | 1 MB | 256 | हाँ |
permissive | 5 min | 100 MB | 10 MB | 1024 | नहीं |
कॉलर प्रति कॉल timeoutMs / fdBudget के माध्यम से कड़ा कर सकता है। कॉलर
प्रोफ़ाइल से आगे नहीं बढ़ा सकता।
| टियर | शर्त |
|---|---|
| LOW | टूल पंजीकृत नहीं (डिफ़ॉल्ट-डिनाई) |
| MEDIUM | पंजीकृत लेकिन argsPatterns खाली (कोई भी args अनुमत) |
| HIGH | argsPatterns सेट लेकिन सैंडबॉक्स या रीप्ले ट्रैकर निष्क्रिय |
| CRITICAL | argsPatterns + सैंडबॉक्स + रीप्ले सभी सक्रिय |
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
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
अनएस्केप्ड ओपनिंग ग्रुपिंग कैरेक्टर्स ((, {, [) तक सीमित है। इन बजट से
अधिक इनपुट मैचिंग से पहले एक नियंत्रित त्रुटि उत्पन्न करते हैं।