Entra ID SecOps MCP Server

Server MCP, der die Sicherheitsprotokolle von Microsoft Entra ID als ausführbare Werkzeuge für einen KI-Agenten (Claude Desktop, Cursor oder jeden anderen MCP-Client) bereitstellt.

Ziel: einem Analysten zu ermöglichen, eine Frage in natürlicher Sprache zu stellen — „Warum kann sich dieses Konto nicht mehr anmelden?“ — und in wenigen Sekunden eine Antwort zu erhalten, die auf den tatsächlichen Daten des Mandanten basiert.

📖 Installations- und Testanleitung — die drei Möglichkeiten, den Server Schritt für Schritt zu starten. 🔍 Technisches Briefing — Marktscan und sichere Exposition.

Designprinzip

Eine rohe Antwort von Microsoft Graph enthält etwa sechzig Felder pro Ereignis. Der Server wendet eine aggressive Kürzung an: Nur etwa ein Dutzend Sicherheitsindikatoren erreichen das Modell. Das ist sowohl eine Kostenoptimierung (Faktor ~35 bei den Tokens) als auch eine Sicherheitskontrolle, da die nicht aufgeführten Felder — von denen einige von einem Angreifer kontrolliert werden — nie in den Kontext gelangen.

Die Aggregate (Anzahl der Fehlschläge, verschiedene IPs, verdächtige Muster) werden in Python berechnet, nicht vom Modell abgeleitet.

Werkzeuge

Alle Werkzeuge sind schreibgeschützt: Der Server ändert niemals den Mandanten.

Empfohlene Untersuchungsreihenfolge

get_user_context     le compte est-il privilégié ? l'incident est-il grave ?
      ↓
get_user_signins     que s'est-il passé sur l'authentification ?
      ↓
get_risk_detections  qu'a détecté Identity Protection, et pourquoi ?
      ↓
get_directory_audits l'attaquant a-t-il modifié quelque chose une fois entré ?

Diese Abfolge ist auch in den instructions des Servers beschrieben, die der MCP-Client an das Modell übermittelt.

Schnellstart (ohne Azure-Mandanten)

Der Modus fixture spielt einen Demo-Vorfall erneut ab und erfordert weder Mandant, Lizenz noch Geheimnis.

python -m venv venv
venv/Scripts/activate          # Windows ; sur Linux/macOS : source venv/bin/activate
pip install -e ".[dev]"

cp .env.example .env           # ENTRA_DATA_SOURCE=fixture est déjà la valeur par défaut
python -m entra_secops_mcp

Verbindung zu einem echten Mandanten

1. Erstellen Sie eine App Registration im Entra-Portal.

2. Fügen Sie die Anwendungsberechtigungen aus der obigen Tabelle hinzu und erteilen Sie dann die Administratorzustimmung.

3. Generieren Sie ein Client-Geheimnis.

4. Füllen Sie die .env-Datei aus:

AZURE_TENANT_ID=...
AZURE_CLIENT_ID=...
AZURE_CLIENT_SECRET=...
ENTRA_DATA_SOURCE=graph

Erforderliche Lizenz. Der Zugriff auf die Anmeldeprotokolle über die API erfordert eine P1-Lizenz für Entra ID, und die Identity-Protection-Tools erfordern P2. Ohne diese antwortet Graph mit 403. Die anderen Tools funktionieren ohne kostenpflichtige Lizenz. Überprüfen Sie die Lizenz des Mandanten bevor Sie beginnen: Das ist das klassische Hindernis, das mehrere Tage kostet.

Sicherheit

• Kein Geheimnis ist im Code oder im Docker-Image vorhanden. Sie werden beim Start über --env-file injiziert.

• .env ist durch .gitignore von Git ausgeschlossen. Ein Geheimnis, das in ein Repository gepusht wurde, muss in Azure widerrufen werden, nicht nur aus der Datei gelöscht werden.

• Die Protokollierung erfolgt auf stderr: Bei stdio-Transport überträgt stdout das JSON-RPC-Protokoll und toleriert keine überflüssigen Bytes.

Konfiguration

Alle Variablen sind in .env.example dokumentiert.

Docker

docker build -t entra-secops-mcp .
docker run -i --rm --env-file .env entra-secops-mcp

Finales Image: 277 MB, mehrstufiger Build, Ausführung als Nicht-Root-Benutzer (uid=1000), keine Geheimnisse in den Schichten.

-i hält den Standardeingang offen — hierüber läuft das MCP-Protokoll. Kein -t: Ein Pseudo-Terminal injiziert Farbcodes, die die JSON-Frames beschädigen.

Entwicklung

pytest              # 81 tests
ruff check src tests
mypy src            # mode strict
pre-commit install  # contrôles avant chaque commit
python demo.py      # investigation de démonstration

Status

Lizenz

MIT.