mcp-policy-gateway
mcp-policy-gateway
Eine Policy-first-MCP-Server-Referenzimplementierung. Sie zeigt, wie man einem Agenten nützliche Werkzeuge bereitstellt, ohne dem Modell zu erlauben, Autorisierungen zu entscheiden, Mandantengrenzen zu überschreiten, direkte personenbezogene Daten (PII) preiszugeben oder eigenständig risikoreiche Mutationen auszuführen.
Dies ist eine Portfolio-/Referenzimplementierung. Alle Datensätze sind synthetisch; es ist keine Produktionssoftware und erhebt nicht den Anspruch, in ein Bank-, Zahlungsabwicklungs- oder Kundensystem integriert zu sein.
Warum dieses Projekt existiert
Ein übliches MCP-Demo stellt einem Modell eine rohe API zur Verfügung und behandelt einen erfolgreichen Tool-Aufruf als Sicherheitsmodell. Dieses Projekt vertritt die gegenteilige Position:
Policy ist deterministisch. Das Modell kann sich nicht selbst autorisieren.
Die Mandantengrenze wird serverseitig durchgesetzt. Ein Tool-Argument kann den Mandanten nicht wechseln.
Die Tool-Ausgabe ist minimiert. Die Kontozusammenfassung schließt Eigentümername und E-Mail bewusst aus.
Risikoreiche Aktionen enden an einem Genehmigungs-Gate. Eine Sperranfrage erzeugt keine Zustandsänderung.
Jede Entscheidung ist auditierbar. Allow-, Deny- und Genehmigungsergebnisse erzeugen strukturierte Audit-Ereignisse.
Mutationsanfragen erfordern einen Grund und einen Idempotenzschlüssel.
Related MCP server: Aegis
Architektur
MCP client / agent
│ tool call
▼
FastMCP stdio adapter
│ verified principal (demo fixture here)
▼
GatewayService ──► PolicyEngine ──► allow / deny / require approval
│ │
▼ ▼
synthetic domain data structured audit eventIn einer Produktionsumgebung würde der Principal aus einer verifizierten Identität/Sitzung außerhalb des Modellkontexts abgeleitet. Akzeptieren Sie tenant_id, Rollen oder Scopes niemals aus einem Tool-Argument oder einer Modellausgabe.
Tools
Tool | Risiko | Verhalten |
| Lesen | Erlaubt nur Fälle im Mandanten des Aufrufers mit dem richtigen Scope. |
| Lesen | Gibt eine minimierte Zusammenfassung zurück; niemals direkte personenbezogene Daten (PII). |
| Mutation | Erfordert einen Scope, einen Grund und einen Idempotenzschlüssel und erfordert dann immer eine menschliche Genehmigung. |
Schnellstart
Erfordert Python 3.11+.
python -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest
.venv/bin/ruff check .Als MCP-stdio-Server ausführen:
.venv/bin/mcp-policy-gatewayDer Adapter verwendet für die lokale Erkundung bewusst einen festen Demo-Principal. Die echte Identitätsweitergabe wird absichtlich als Produktionsintegrationsaspekt dokumentiert und hier nicht simuliert.
Demonstrierte Missbrauchskontrollen
Die Tests beweisen, dass das Gateway:
einem Agenten aus
tenant_redden Zugriff auf Daten vontenant_blueverweigert;einen Tool-Aufruf ohne den erforderlichen Scope verweigert;
Eigentümername oder E-Mail nicht über das Zusammenfassungs-Tool zurückgibt;
require_approvalzurückgibt, anstatt den Kontostatus zu mutieren; undzustandsändernde Anfragen ablehnt, die einen Grund oder Idempotenzschlüssel auslassen.
Bedrohungsmodell und Nicht-Ziele
Siehe THREAT_MODEL.md. Das Design ist bewusst eng gefasst: Es demonstriert eine Policy-Grenze um MCP-Tools, nicht eine vollständige Identitätsinfrastruktur, dauerhafte Audit-Speicherung, Secrets-Management oder ein Zahlungs-/Hauptbuchsystem.
Interview-Durchlauf
Eine prägnante Möglichkeit, das Projekt zu erklären:
Ich habe die MCP-Grenze so gestaltet, dass das Modell über sichere, scoped Daten nachdenken kann, aber keinen Zugriff entscheiden oder risikoreiche Aktionen ausführen kann. Die Autorisierung ist deterministisch, die Mandantenisolierung wird serverseitig durchgesetzt, die Tool-Oberfläche minimiert personenbezogene Daten (PII), und sensible Mutationen enden in einem auditierbaren menschlichen Genehmigungs-Gate.
Entwicklung
.venv/bin/pytest
.venv/bin/ruff check .CI führt beide Prüfungen bei Pushes und Pull Requests aus.
Lizenz
MIT. Siehe 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.-