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 フック: 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