aegis-mcp

aegis-mcp-server

Aegis エージェントガバナンス仕様のための MCP 適用レイヤーです。

ポリシーは基盤に。実行時に適用し、すべてのアクションに説明責任を持たせます。

概要

aegis-mcp-server は、エージェントのあらゆるアクションが実行される前に、.agentpolicy/ ファイルに照らして検証する MCP サーバーです。パス権限、コンテンツスキャン、ロールの境界、品質ゲートなどをすべて実行時に適用し、エージェントのトークン消費はゼロです。

エージェントがガバナンスファイルを読み込むことはありません。MCP サーバーがそれらを自身のプロセスメモリに読み込み、サイレントに検証します。エージェントがガバナンス対象のツールを呼び出すと、成功結果、または具体的な理由を示すブロック応答が返されます。

クイックスタート

# Install globally
npm install -g aegis-mcp-server

aegis-cli でポリシーを生成した場合、.mcp.json の接続設定はすでにプロジェクトのルートにあります。MCP をインストールしてエージェントを起動するだけで、自動的に接続されます。

最初のプロンプト

ガバナンス対象のプロジェクトで新しいエージェントセッションを開始する際は、最初のプロンプトとして次を使用してください。

Call aegis_policy_summary now. This is your governance contract — it defines your
role, your boundaries, and which tools to use. Do not take any action until you have
called this tool and received confirmation from the user to proceed.

初期ビルドでは、Aegis CLI がプロジェクトに合わせたカスタムの引き継ぎプロンプトを生成します。代わりにそちらを使用してください。

仕組み

ユニバーサルモード（デフォルト）

MCP は、事前にロールを割り当てずに起動します。エージェントが aegis_policy_summary を呼び出すと、組み込みの construction ロールと .agentpolicy/roles/ のすべての専門ロールを含む、利用可能なロールの一覧が返されます。エージェントがユーザーに提示し、ユーザーが選択すると、エージェントは aegis_select_role を呼び出してロールを確定します。以降のセッションでは、選択したロールに基づいてすべての適用処理が行われます。

これがデフォルトの動作です。aegis init が自動作成する .mcp.json 以外に、設定は必要ありません。

construction モード

初期ビルドや大規模な再構成では、construction ロールをいつでも利用できます。選択すると、次のようになります。

• エージェントはリポジトリ全体にアクセスできます（すべてのパスで読み取りと書き込みが可能です）
• .agentpolicy/ ファイルが設計図として機能します。エージェントは憲章、ガバナンス、ロールの各ファイルを読み、プロジェクトのアーキテクチャ、規約、品質基準を把握します
• ファイル操作は、速度を優先してガバナンス対象のツールではなくネイティブツールを介して実行されます
• MCP は、タイムスタンプと human_confirmed: true を含めて、construction セッションの開始を state/overrides.jsonl に記録します
• ビルドが完了すると、エージェントは aegis_complete_task を呼び出して品質ゲートを実行し、construction モードを終了します。終了時のタイムスタンプは開始時の記録とともにログに記録されます
• construction 後のすべてのセッションでは、ガバナンス対象の操作に専門ロールを選択してください

construction モードはバイパスではありません。エージェントは引き続き、ガバナンスファイルを設計図として従います。すべてのファイルに書き込み制限を適用すると逆効果になる新規構築プロジェクトで、処理を高速化するためのモードです。

固定モード

起動時に割り当てるロールが決まっている場合は、次のようにします。

{
  "mcpServers": {
    "aegis": {
      "command": "aegis-mcp",
      "args": ["--project", ".", "--role", "backend"]
    }
  }
}

MCP はそのロールにただちに固定されます。aegis_policy_summary はロール選択を省略し、そのロールの境界を直接返します。

ツール

ツール	機能	トークンコスト
aegis_policy_summary	役割の境界とガバナンスの概要（ユニバーサルモードでは利用可能な役割）	約200トークン
aegis_select_role	ユニバーサルモードで役割を選択（構築を含む）	わずか
aegis_check_permissions	操作が許可されているか事前に確認	わずか
aegis_write_file	パスと内容を検証したうえで、ガバナンスに従って書き込み	通常の書き込みと同じ
aegis_read_file	パスを検証したうえで、ガバナンスに従って読み取り	通常の読み取りと同じ
aegis_delete_file	パスを検証したうえで、ガバナンスに従って削除	わずか
aegis_execute	ガバナンスに従ってコマンドを実行	コマンド出力のみ
aegis_complete_task	品質ゲートを実行し、構築モードが有効な場合は終了	ゲートの結果のみ
aegis_request_override	人間の確認後に、ブロックされた操作を実行	わずか

トークンオーバーヘッドなし

従来の方法では、ガバナンスファイルをエージェントのコンテキストウィンドウに読み込みます。トークンコストはポリシーの複雑さに応じて増加します。

Aegis MCP の方法では、サーバーが自身のプロセスメモリにポリシーを読み込みます。エージェントはツールを呼び出し、構造化された結果を受け取ります。ガバナンスが200行あるプロジェクトも、20行のプロジェクトとトークンコストは同じです。複雑さを処理するのはエージェントではなく、サーバーです。

強制

• ガバナンス境界 — writable、read_only、forbidden のパスリスト
• 役割のスコープ設定 — エージェントが各自の役割で読み書き可能なパスに制限されます
• 機密パターンの検出 — ガバナンスで定義された正規表現パターンに照らして内容をスキャンします（パスではなく内容のみが対象です）
• ドメイン間の境界 — インポートを共有インターフェースのルールに照らして検証します
• 品質ゲートの検証 — pre_commit フラグを build_commands に対応付けて実行します
• オーバーライドの記録 — ブロックされた操作はすべて、追記専用の overrides.jsonl に記録されます
• 変更不可のポリシー — いかなる場合もオーバーライドできない指定ルール
• 構築セッションの記録 — 初期構築の開始時刻と終了時刻

オーバーライドプロトコル

操作がブロックされ、ガバナンスのオーバーライド動作が warn_confirm_and_log の場合：

1. ブロックされた操作への応答には、override_token と違反した特定のポリシーが含まれます
2. エージェントは違反内容をユーザーに提示します
3. ユーザーが確認した場合、エージェントはトークンとユーザーの理由を指定して aegis_request_override を呼び出します
4. 操作が実行され、オーバーライドは human_confirmed: true として記録されます
5. 通常のガバナンスが直ちに再開されます — オーバーライドは一度限りの例外です

変更不可のポリシー（HIPAA コンプライアンス、ITAR データ主権、監査の完全性など）は override_available: false を返し、オーバーライドできません。ユーザーは aegis init を通じてガバナンスを変更する必要があります。

同意に基づくガバナンス

Aegis MCP はエージェント本来の指示を上書きしません。ツールの説明を通じて自身を紹介し、ガバナンスが有効な理由を説明したうえで、書き込み操作を Aegis ツール経由で実行する許可をユーザーに求めるようエージェントに促します。ユーザーの権限が強制の仕組みとなります。

コードベースの読み取り、検索、調査に使用するネイティブツールは、ガバナンスによる制限がなくても問題なく機能します。Aegis 経由で実行するメリットがあるのは、書き込み、削除、実行操作のみです。

アーキテクチャ

Agent ──→ aegis-mcp-server ──→ File System
              │
              ├── Loads .agentpolicy/ into process memory (once)
              ├── Watches for policy changes (auto-reload)
              ├── Validates every tool call against policy
              ├── Returns success or blocked with override option
              └── Logs all enforcement decisions to overrides.jsonl

3つの成果物、1つのガバナンスフレームワーク：

• aegis-spec — ガバナンス標準
• aegis-cli — ガバナンスを生成
• aegis-mcp-server — ガバナンスを強制

ライセンス

MIT