Skip to main content
Glama
mcp-policy-gateway

mcp-policy-gateway

by jcorrego

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 event

In 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

get_case(case_id)

Lesen

Erlaubt nur Fälle im Mandanten des Aufrufers mit dem richtigen Scope.

get_account_summary(account_id)

Lesen

Gibt eine minimierte Zusammenfassung zurück; niemals direkte personenbezogene Daten (PII).

request_account_freeze(...)

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-gateway

Der 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:

  1. einem Agenten aus tenant_red den Zugriff auf Daten von tenant_blue verweigert;

  2. einen Tool-Aufruf ohne den erforderlichen Scope verweigert;

  3. Eigentümername oder E-Mail nicht über das Zusammenfassungs-Tool zurückgibt;

  4. require_approval zurückgibt, anstatt den Kontostatus zu mutieren; und

  5. zustandsä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 tools
get_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

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enforces 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables governing tenant-aware MCP tools with policy enforcement, scoped access, human approval workflows, and tamper-evident audit logging.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enforces default-deny policies, budgets, and tamper-evident audit logging for MCP tool calls before they reach upstream servers.
      -