workflow-guard-mcp

Salvaguardas portátiles para clientes de codificación agénticos que hablan el Model Context Protocol (MCP).

El proyecto pretende reducir el radio de impacto de los flujos de trabajo de codificación rápidos y altamente autónomos, proporcionando a los clientes un punto de decisión de políticas compartido. El servidor MCP no ejecuta por sí mismo la acción propuesta.

Estado

Este repositorio es un andamiaje inicial. La herramienta guard_check actual demuestra un contrato estable de decisión de políticas; aún no es una adaptación completa de las políticas de opencode-workflow-guard.

Lo más importante es que conectar un servidor MCP no lo convierte en un interceptor de todas las herramientas nativas que un cliente de codificación puede ejecutar. La aplicación estricta de las políticas depende del soporte de integración del host. Consulta Compatibilidad y Plan.

Related MCP server: Vaikora Guard MCP

Herramientas

• guard_check: evalúa una acción propuesta de tipo shell, file_write, git o network y devuelve allow, deny o ask con un ID de política legible por máquina.

• guard_status: informa del modo de aplicación de políticas actual del servidor. Identifica explícitamente este andamiaje como un asesoramiento de políticas dependiente del host.

Desarrollo

Requiere Node.js 20 o superior.

npm install
npm test
npm run typecheck
npm run build

El transporte inicial es stdio porque tanto Claude Code como Codex admiten servidores MCP stdio locales. Se puede añadir Streamable HTTP sin cambiar la API de políticas.

Principio de diseño

La promesa pública es deliberadamente más limitada que «este MCP aísla a tu agente de codificación en un sandbox». Centraliza las políticas. Los adaptadores del cliente aplican esa política allí donde el cliente exponga un mecanismo de interceptación fiable; de lo contrario, el resultado sigue siendo orientativo y debe combinarse con el sandbox nativo del cliente y sus controles de aprobación.

Fuentes

El diseño de compatibilidad se contrastó con la documentación oficial y el código fuente actuales el 27 de agosto de 2026:

• 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

• Implementación de la configuración MCP de Codex: 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

Licencia

MIT