mcp-policy-gateway
mcp-policy-gateway
ポリシー優先のMCPサーバー リファレンス実装。エージェントに有用なツールを提供しつつ、モデルが認可を決定したり、テナント境界を越えたり、直接的なPIIを漏洩させたり、高影響の変更を単独で実行したりすることを防ぐ方法を示します。
これはポートフォリオ/リファレンス実装です。すべてのレコードは合成データであり、本番ソフトウェアではなく、銀行、決済処理業者、顧客システムとの統合を主張するものではありません。
なぜこれが存在するのか
一般的なMCPデモは、生のAPIをモデルに公開し、ツール呼び出しの成功をセキュリティモデルとして扱います。このプロジェクトは逆の立場を取ります:
ポリシーは決定的です。 モデルは自分自身を認可できません。
テナント境界はサーバー側で強制されます。 ツール引数でテナントを切り替えることはできません。
ツール出力は最小化されます。 アカウントサマリーは意図的に所有者名とメールを除外します。
高影響のアクションは承認ゲートで停止します。 凍結リクエストは状態変更を生成しません。
すべての決定は監査可能です。 許可、拒否、承認必須の結果は構造化された監査イベントを生成します。
変更リクエストには理由と冪等性キーが必要です。
Related MCP server: Aegis
アーキテクチャ
MCP client / agent
│ tool call
▼
FastMCP stdio adapter
│ verified principal (demo fixture here)
▼
GatewayService ──► PolicyEngine ──► allow / deny / require approval
│ │
▼ ▼
synthetic domain data structured audit event本番デプロイでは、プリンシパルはモデルコンテキスト外の検証済みアイデンティティ/セッションから導出されます。tenant_id、ロール、スコープをツール引数やモデル出力から受け入れてはいけません。
ツール
ツール | リスク | 動作 |
| 読み取り | 呼び出し元のテナント内で適切なスコープを持つケースのみを許可します。 |
| 読み取り | 最小化されたサマリーを返します。直接的なPIIは決して返しません。 |
| 変更 | スコープ、理由、冪等性キーを要求し、その後常に人間の承認を要求します。 |
クイックスタート
Python 3.11+ が必要です。
python -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest
.venv/bin/ruff check .MCP stdioサーバーとして実行:
.venv/bin/mcp-policy-gatewayアダプターはローカル探索用に意図的に固定されたデモプリンシパルを使用します。実際のアイデンティティ伝播は、ここで偽装するのではなく、本番統合の関心事として意図的に文書化されています。
実証された悪用防止策
テストはゲートウェイが以下を証明します:
tenant_redのエージェントがtenant_blueのデータを読み取ろうとするのを拒否します。必要なスコープなしのツール呼び出しを拒否します。
サマリーツールを通じて所有者名やメールを返しません。
アカウント状態を変更する代わりに
require_approvalを返します。理由または冪等性キーを省略した状態変更リクエストを拒否します。
脅威モデルと非目標
THREAT_MODEL.md を参照してください。設計は意図的に狭い範囲です:MCPツールの周囲のポリシー境界を示すものであり、完全なアイデンティティ基盤、永続的な監査ストレージ、シークレット管理、または決済/台帳システムではありません。
面接ウォークスルー
プロジェクトを簡潔に説明する方法:
モデルが安全でスコープされたデータを推論できるが、アクセスを決定したり高影響のアクションを実行したりできないようにMCP境界を設計しました。認可は決定的であり、テナント分離はサーバー側で強制され、ツールサーフェスはPIIを最小化し、機密性の高い変更は監査可能な人間の承認ゲートで終了します。
開発
.venv/bin/pytest
.venv/bin/ruff check .CIはプッシュとプルリクエストの両方で両方のチェックを実行します。
ライセンス
MIT。 LICENSE を参照してください。
Available Tools
3 toolsget_account_summaryB
Return a minimized account summary; this tool never exposes direct PII.
Inputs: account_id (required).
get_caseA
Retrieve a support case inside the caller's tenant boundary.
Inputs: case_id (required).
request_account_freezeB
Request a high-impact account freeze. Policy always requires human approval.
Inputs: reason (required), account_id (required), idempotency_key (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct resource/action: case retrieval, account summary (with PII restriction), and a freeze request. There is no overlap in purpose, and the descriptions clearly differentiate the operations.
All tool names follow a consistent verb_noun pattern (get_case, get_account_summary, request_account_freeze). The verbs are clear and the nouns identify the target, making the set predictable and easy to navigate.
With only 3 tools, the server is tightly scoped and each tool serves a distinct, essential function within the policy gateway context. This is within the typical 3-15 range and feels appropriately lean rather than sparse.
The tools cover core read operations and a high-impact action, but there are notable gaps: no listing of cases or accounts, no update/modification paths, and no way to track the status of a freeze request. Agents would need to work around these missing operations.
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Zero-secret MCP gateway for AI agents: risk-scored, audited calls with human-in-the-loop approval.
One MCP endpoint for your company's tools, with per-person sign-in, policy and audit.
Governed MCP gateway for business apps: roles, previews, approvals and one audit log.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnforces fine-grained, context-aware access control on MCP tool calls, with a tamper-evident, replayable audit log that records denials and verifies every decision.MIT
- AlicenseNot gradedqualityDmaintenanceEnables governing tenant-aware MCP tools with policy enforcement, scoped access, human approval workflows, and tamper-evident audit logging.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to safely access upstream MCP servers through centralized policy enforcement, including allow/deny/approval decisions, schema pinning, circuit breakers, and audit logging.MIT
- FlicenseNot gradedqualityCmaintenanceEnforces default-deny policies, budgets, and tamper-evident audit logging for MCP tool calls before they reach upstream servers.-