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 작업을 평가하고 기계가 읽을 수 있는 정책 ID와 함께 allow, deny 또는 ask를 반환합니다.

• guard_status: 서버의 현재 강제 실행 모드를 보고합니다. 이 스캐폴드가 호스트에 종속적인 정책 조언임을 명시적으로 식별합니다.

개발

Node.js 20 이상이 필요합니다.

npm install
npm test
npm run typecheck
npm run build

초기 전송 방식은 stdio입니다. Claude Code와 Codex 모두 로컬 stdio MCP 서버를 지원하기 때문입니다. Streamable HTTP는 정책 API를 변경하지 않고 추가할 수 있습니다.

설계 원칙

공개적인 약속은 의도적으로 "이 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