workflow-guard-mcp

为使用 Model Context Protocol (MCP) 的编码智能体客户端提供可移植的安全护栏。

该项目旨在通过向客户端提供一个共享的策略决策点，来缩小快速、高度自主的编码工作流的爆炸半径。MCP 服务器本身不执行拟议的操作。

状态

本仓库是一个早期脚手架。当前的 guard_check 工具展示了一种稳定的策略决策契约；它还不是 opencode-workflow-guard 策略的完整移植。

最重要的是，连接一个 MCP 服务器并不会使其成为编码客户端可执行的每个原生工具的拦截器。强制实施取决于宿主对集成的支持。参见 兼容性 和 计划。

Related MCP server: Vaikora Guard MCP

工具

• guard_check：评估提议的 shell、file_write、git 或 network 操作，并返回 allow、deny 或 ask 以及一个机器可读的策略 ID。

• guard_status：报告服务器当前的执行模式。它明确地将此脚手架标识为依赖宿主的策略建议。

开发

需要 Node.js 20 或更高版本。

npm install
npm test
npm run typecheck
npm run build

初始传输使用 stdio，因为 Claude Code 和 Codex 都支持本地 stdio MCP 服务器。可以在不更改策略 API 的情况下添加 Streamable HTTP。

设计原则

对外承诺的范围刻意窄于“此 MCP 会将你的编码智能体沙箱化”。它将策略集中化。客户端适配器在客户端暴露可信拦截机制的任何地方强制执行该策略；否则，结果仍仅为建议，并应与客户端原生的沙箱和审批控制结合使用。

来源

兼容性设计已于 2026-08-27 对照当前官方文档和源代码进行了核对：

• 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

• Codex MCP 配置实现：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

许可证

MIT