mm.tech
security stable TypeScript

MCP Stdio Shellguard

Defense-in-Depth-Bundle für MCP-stdio-Server

Drop-in guardExec- und guardSpawn-Wrapper, AST-Audit-CLI, Referenz-MCP-Server. Schließt die OX-Security-stdio-RCE-Klasse (CVE-2025-69256, 200k betroffene Server). Unicode-Bypass-gehärtet, Allowlist-basiert, Replay-Window-geschützt. MIT, TypeScript, Node 20+.

Welches Problem es löst

Im Mai 2026 wurde die stdio-Klasse für Codeausführung in MCP-Servern offengelegt, und die Zahl verwundbarer Server ging in die Größenordnung von zweihunderttausend. Die Form ist immer dieselbe: ein Werkzeug nimmt ein Argument und reicht es ungesäubert an eine Shell weiter. Das hier schließt diese Klasse auf drei Wegen, die du einzeln einführen kannst.

Wie es arbeitet

Die erste Schicht ist eine Bibliothek: Ersatz für exec und spawn, den du aus deinem eigenen Server aufrufst, mit grundsätzlich sperrender Positivliste, Sandkasten-Profilen und einem Wiederholungsfenster. Die zweite ist ein Prüfbefehl, der den Syntaxbaum deiner Quellen durchgeht und jeden ungesäuberten Shell-Aufruf meldet, den er findet, und den du mit npx ohne Installation laufen lassen kannst. Die dritte ist die Normalisierung, die sich beide teilen: NFKC-Faltung, Entfernen von Nullbreiten-Zeichen und Sperren von Richtungsmarken, derselbe Durchgang wie in mcp-rce-guard.

Wann du es nimmst

Wenn du einen MCP-Server pflegst, der überhaupt eine Shell aufruft, lass zuerst den Prüfbefehl über deine Quellen laufen. Er kostet eine npx-Zeile und sagt dir, ob du in der betroffenen Klasse bist, bevor du entscheidest, wie viel von der Bibliothek du übernimmst.

Wann du es nicht nimmst

Es bewacht die Aufrufe, die du durch es hindurchleitest. Ein Shell-Aufruf an anderer Stelle in deinem Prozess bleibt unberührt, und genau deswegen gibt es den Prüfbefehl: die Bibliothek allein gibt dir ein falsches Gefühl von Abdeckung, wenn du nie nachgesehen hast, wo du sonst noch eine Shell aufrufst. Es zielt auf die MCP-Spezifikation vom 18.06.2025 und braucht Node 20 oder neuer.

Stars

★ 0

installs

↓ 1,142

Clones (14d)

⊟ 209

Sprache

TypeScript

Aktualisiert

2026-08-21

Installation

npx -y mcp-stdio-shellguard

Verwandte Repos