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 поддерживают локальные MCP-серверы на stdio. Streamable HTTP можно добавить без изменения API политик.

Принцип проектирования

Публичное обещание намеренно уже, чем «этот MCP помещает вашего кодинг-агента в песочницу». Он централизует политики. Клиентские адаптеры применяют эту политику везде, где клиент предоставляет надёжный механизм перехвата; в противном случае результат остаётся рекомендательным и его следует сочетать со встроенными средствами песочницы и контроля одобрений клиента.

Источники

Дизайн совместимости был проверен по актуальной официальной документации и исходному коду на 2026-08-27:

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

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

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

• Реализация конфигурации MCP в 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

Лицензия

MIT