
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
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 बंडल और मैनिफ़ेस्ट समायोजनों को रिकॉर्ड करती है।
यह आपको क्या देता है
तीन परतें, टुकड़ों में ऑप्ट-इन:
- लाइब्रेरी API — ड्रॉप-इन
guardExec/guardSpawnजिन्हें आप अपने स्वयं के MCP सर्वर से कॉल करते हैं। डिफ़ॉल्ट-डिनाई अनुमति-सूची, सैंडबॉक्स प्रोफ़ाइल, रीप्ले विंडो। - ऑडिट CLI —
mcp-shellguard-audit scan <path>AST को ट्रैवर्स करता है, LOW (no timeout) से CRITICAL (exec(\...${userInput}...`)`) तक 12 एंटी-पैटर्न रिपोर्ट करता है। - संदर्भ MCP सर्वर —
mcp-stdio-shellguard-demo8 टूल्स को उजागर करता है ताकि 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
ऑडिट 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
अनएस्केप्ड ओपनिंग ग्रुपिंग कैरेक्टर्स ((, {, [) तक सीमित है। इन बजट से
अधिक इनपुट मैचिंग से पहले एक नियंत्रित त्रुटि उत्पन्न करते हैं।