workflow-guard-mcp

Portable Guardrails für agentische Coding-Clients, die das Model Context Protocol (MCP) sprechen.

Das Projekt soll den Schadensradius schneller, hochautonomer Coding-Workflows verringern, indem es den Clients einen gemeinsamen Punkt für Richtlinienentscheidungen bietet. Der MCP-Server führt die vorgeschlagene Aktion nicht selbst aus.

Status

Dieses Repository ist ein frühes Grundgerüst. Das aktuelle Tool guard_check demonstriert einen stabilen Vertrag für Richtlinienentscheidungen; es ist noch keine vollständige Portierung der opencode-workflow-guard-Richtlinien.

Am wichtigsten: Das Anbinden eines MCP-Servers macht ihn nicht zu einem Interceptor für jedes native Tool, das ein Coding-Client ausführen kann. Eine harte Durchsetzung hängt von der Integrationsunterstützung im Host ab. Siehe Kompatibilität und Plan.

Related MCP server: Vaikora Guard MCP

Werkzeuge

• guard_check: bewertet eine vorgeschlagene Aktion vom Typ shell, file_write, git oder network und gibt allow, deny oder ask mit einer maschinenlesbaren Richtlinien-ID zurück.

• guard_status: meldet den aktuellen Durchsetzungsmodus des Servers. Es kennzeichnet dieses Grundgerüst ausdrücklich als hostabhängige Richtlinienempfehlung.

Entwicklung

Erfordert Node.js 20 oder neuer.

npm install
npm test
npm run typecheck
npm run build

Der anfängliche Transport ist stdio, da sowohl Claude Code als auch Codex lokale stdio-MCP-Server unterstützen. Streamable HTTP kann hinzugefügt werden, ohne die Richtlinien-API zu ändern.

Designprinzip

Das öffentliche Versprechen ist bewusst enger gefasst als „Dieser MCP sandboxt Ihren Coding-Agenten.“ Es zentralisiert die Richtlinien. Client-Adapter setzen diese Richtlinie überall dort durch, wo der Client einen vertrauenswürdigen Abfangmechanismus bereitstellt; andernfalls bleibt das Ergebnis lediglich eine Empfehlung und sollte mit den nativen Sandbox- und Genehmigungskontrollen des Clients kombiniert werden.

Quellen

Das Kompatibilitätsdesign wurde am 2026-08-27 gegen die aktuelle offizielle Dokumentation und den Quellcode geprüft:

• Anthropic Claude Code MCP: https://docs.claude.com/en/docs/claude-code/mcp

• Anthropic Claude Code hooks: https://github.com/anthropics/claude-code/blob/main/plugins/plugin-dev/skills/hook-development/SKILL.md

• OpenAI Codex: https://github.com/openai/codex

• Implementierung der Codex-MCP-Konfiguration: https://github.com/openai/codex/blob/main/codex-rs/config/src/mcp_types.rs

• MCP TypeScript SDK: https://github.com/modelcontextprotocol/typescript-sdk/blob/v1.29.0/docs/server.md

Lizenz

MIT