Agent Policy Builder MCP

🚀 🧩 GlassTape Policy Builder MCP Server

自然言語を本番環境で使用可能なAIガバナンスポリシーに変換します。

GlassTapeのPolicy Builderは、オープンソースのMCPサーバーです。自然言語のセキュリティ要件を自動検証、テスト、レッドチーミング付きのCerbos YAMLポリシーに変換します。 これにより、セキュリティチームとエンジニアリングチームは、AIエージェントとアプリケーションをポリシーアソードコードフレームワークと統合でき、ツール呼び出しの傍受、データアクセス、モデルワークフローにゼロトラストのガードレールを導入できます。

✨ 主な機能

• ⚙️ 自然言語からポリシーへ – ClaudeまたはAWS Qを使用して、平易な英語からCerbosポリシーを生成します。
• 🧠 自動検証 – Cerbos CLI（cerbos compile、cerbos test）を使用して、構文とロジックをチェックします。
• 🧪 レッドチーム分析 – 6項目のセキュリティ分析と自動改善提案を行います。
• 🧩 MCP統合 – Cursor、Zed、Claude DesktopなどのIDEでネイティブに動作します。
• 🔒 エアギャップ運用 – 外部依存関係のないローカルファーストの設計です。
• 🏷️ トピックベースのガバナンス – 40以上のコンテンツトピックとセーフティ分類があります。
• 🧾 コンプライアンステンプレート – SOX、HIPAA、PCI-DSS、EU AI Act用の組み込みテンプレートがあります。

🚀 クイックスタート

1. 前提条件

Cerbos CLIをインストール（ポリシー検証に必要）：

# macOS
brew install cerbos/tap/cerbos

# Linux
curl -L https://github.com/cerbos/cerbos/releases/latest/download/cerbos_Linux_x86_64 \
  -o /usr/local/bin/cerbos && chmod +x /usr/local/bin/cerbos

# インストールを確認
cerbos --version

2. ソースからインストール

# リポジトリをクローン
git clone https://github.com/glasstape/glasstape-policy-builder-mcp.git
cd glasstape-policy-builder-mcp/agent-policy-builder-mcp

# 基本的なインストール
pip install -e .

# オプションのLLMサポート付き（サーバー側の自然言語解析用）
pip install -e ".[anthropic]"  # Anthropic Claude
pip install -e ".[openai]"     # OpenAI GPT
pip install -e ".[llm]"        # すべてのLLMプロバイダー

# 開発用インストール
pip install -e ".[dev]"

3. MCPクライアントを設定

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "glasstape-policy-builder": {
      "command": "glasstape-policy-builder-mcp"
    }
  }
}

Cursor/Zed：IDEのMCP設定に同様の設定を追加します。

オプション：サーバー側のLLM（自然言語処理用）：

{
  "mcpServers": {
    "glasstape-policy-builder": {
      "command": "glasstape-policy-builder-mcp",
      "env": {
        "LLM_PROVIDER": "anthropic",
        "ANTHROPIC_API_KEY": "sk-ant-your-key"
      }
    }
  }
}

4. 使用例

ポリシーを生成（Claude DesktopまたはMCP対応のIDEで）：

Create a payment policy for AI agents:
- Allow payments up to $50
- Block sanctioned entities
- Limit to 5 transactions per 5 minutes

利用可能なテンプレートを一覧表示：

list_templates

ポリシーを検証：

validate_policy with policy_yaml: "<your-cerbos-yaml>"

5. トラブルシューティング

Cerbos CLIが見つからない場合：

• Cerbos CLIがインストールされており、PATHに含まれていることを確認してください。
• インストールを確認するには、cerbos --versionを実行してください（注：--versionでversionではありません）。

MCPサーバーに接続できない場合：

• MCPクライアントの設定を確認してください。
• 設定を変更した後、IDEを再起動してください。
• コマンドパスが正しいことを確認してください：which glasstape-policy-builder-mcp。

インストールが「Unable to determine which files to ship」で失敗する場合：

• これは既知のhatchビルドの問題です。正しいディレクトリにいることを確認してください。
• pyproject.tomlには[tool.hatch.build.targets.wheel]の設定が含まれている必要があります。

MCPでインポートエラーが発生する場合：

• 正しいMCPインポートがあることを確認してください：from mcp.server import Server。
• 再インストールを試してください：pip install -e . --force-reinstall。

ポリシー検証が失敗する場合：

• 生成されたポリシーのYAML構文を確認してください。
• Cerbos CLIが正常に動作していることを確認してください：cerbos compile --help。
• 特定の問題についてエラーメッセージを確認してください。

インストール後にコマンドが見つからない場合：

• Python 3.10以上がインストールされていることを確認してください。
• pyproject.tomlでエントリポイントが正しく構成されていることを確認してください。

🦭 利用可能なツール

MCPを介して接続すると、ClaudeまたはIDEで以下のツールを使用できます。

例のワークフロー：

1. "Generate a payment policy for AI agents with $50 limit..."
   → Claudeがgenerate_policyを呼び出します。
   
2. "Show me available financial templates"
   → Claudeがlist_templatesを呼び出します。
   
3. "Test this policy with the test suite"
   → Claudeがtest_policyを呼び出します。
   
4. "Analyze this policy for security issues"
   → Claudeがsuggest_improvementsを呼び出します。
   
5. "Validate the policy syntax"
   → Claudeがvalidate_policyを呼び出します。

🧪 出力例

入力：

"Allow AI agents to execute payments up to $50. Block sanctioned entities. 
Limit cumulative hourly amount to $50. Maximum 5 transactions per 5 minutes."

トピックガバナンス付きの生成されたポリシー：

# policies/payment_policy.yaml
apiVersion: api.cerbos.dev/v1
resourcePolicy:
  version: "1.0.0"
  resource: "payment"
  rules:
    - actions: ["execute"]
      effect: EFFECT_ALLOW
      condition:
        match:
          expr: >
            request.resource.attr.amount > 0 &&
            request.resource.attr.amount <= 50 &&
            !(request.resource.attr.recipient in request.resource.attr.sanctioned_entities) &&
            (request.resource.attr.cumulative_amount_last_hour + request.resource.attr.amount) <= 50 &&
            request.resource.attr.agent_txn_count_5m < 5 &&
            has(request.resource.attr.topics) &&
            "payment" in request.resource.attr.topics &&
            !("adult" in request.resource.attr.topics)
    - actions: ["*"]
      effect: EFFECT_DENY

その他：

• ✅ トピックベースのガバナンス（支払い、PII検出）
• ✅ セーフティ分類（G/PG/PG_13/R/成人コンテンツ）
• ✅ 15以上の自動テストケース
• ✅ cerbos compileによる検証
• ✅ 6項目のセキュリティ分析
• ✅ デプロイ可能なバンドル

📋 完全な例

完全な例については、examples/README.mdを参照してください。

🧱 アーキテクチャ

flowchart TD
  A["自然言語のポリシー要求"] --> B["GlassTape MCPサーバー"]
  B --> C["中間正規ポリシー - JSON"]
  C --> D["Cerbos YAMLポリシー生成"]
  D --> E["Cerbos CLI検証 + テスト"]
  E --> F["デプロイ可能なポリシーバンドル"]

主要な革新点： ICP（中間正規ポリシー）は言語に依存しない中間表現として機能し、決定論的な生成、ポリシーの移植性、形式的検証を可能にします。

🧪 開発

# クローンしてセットアップ
git clone https://github.com/glasstape/glasstape-policy-builder-mcp.git
cd glasstape-policy-builder-mcp
pip install -e ".[dev]"

# テストを実行
pytest

# コードをフォーマット
black src/ tests/

🤝 コントリビューション

コントリビューションを歓迎します！ガイドラインについては、CONTRIBUTING.mdを参照してください。

クイックリンク：

• 行動規範
• セキュリティポリシー

📄 ライセンス

Apache 2.0ライセンスの下でリリースされています。 © 2025 GlassTape, Inc.

💡 リンク

• 🌐 GlassTapeウェブサイト
• 📚 ドキュメント
• 🧱 Cerbosドキュメント
• 🧩 モデルコンテキストプロトコル
• 🐛 問題を報告

GlassTapeによって愛情を込めて作成されました — AIエージェントをデフォルトで安全にします。