Sophos Central MCP (schreibgeschützt)

Inoffizieller MCP-Server, der schreibgeschützte Sophos Central-Informationen bereitstellt: Antiviren-/Endpoint-Status, Firewall-Bestand und -Status, Switch-Einstellungen sowie E-Mail-Schutz (Quarantäne, Postfächer, Clawback-Status). Entwickelt auf Basis der öffentlichen Sophos Central APIs unter Verwendung der eigenen Postman-Collection des Herstellers als Quelle der Wahrheit für Pfade, Header und Antwortstrukturen.

Nicht verbunden mit, unterstützt von oder gesponsert durch Sophos.

Umfang: schreibgeschützt, absichtlich

Dieser Server implementiert überhaupt keine mutierenden Endpunkte – nicht hinter einem Flag, nicht hinter einer Deny-Liste, sie sind schlicht nicht eingebunden. Absichtlich ausgeschlossen:

• Endpoint: Isolieren/Aufheben, Tamper-Schutz-Änderungen, Policy CRUD, Scans, forensische Logs/Memory-Dumps, Endpoint-Gruppen CRUD, Migrationen.

• Firewall: Firmware-Upgrades, Neustart/sonstige Firewall-Aktionen, Firewall-Gruppen CRUD, MDR-Threat-Feed-Indikator-Schreibvorgänge.

• Switch: MAC-Filter-Liste-Schreibvorgänge.

• E-Mail: Quarantäne/Post-Delivery-Quarantäne-Freigabe oder -Löschung, Clawback-Einleitung, Postfach erstellen/aktualisieren/löschen/massenhaft, Alias/Delegate/Vertriebslistenbesitzer-Schreibvorgänge, Anhang entfernen/wieder anhängen/herunterladen.

Wenn Sie eine dieser Funktionen benötigen, sind sie in Sophos' API dokumentiert, aber hier nicht implementiert – erstellen Sie ein Issue oder fügen Sie ein Tool hinzu, das dem gleichen Muster in src/tools.ts folgt.

Authentifizierung

Sophos Central verwendet OAuth2-Clientanmeldedaten. Erstellen Sie eine API-Anmeldeinformation in Sophos Central unter Einstellungen > API-Anmeldeinformationsverwaltung, die Ihnen eine Client-ID und ein Client-Geheimnis für einen Mandanten (oder ein Organisations-/Partnerkonto, das mehrere Mandanten verwaltet) gibt.

SOPHOS_CLIENT_ID=...
SOPHOS_CLIENT_SECRET=...

Der Server tauscht diese gegen ein Zugriffstoken aus (https://id.sophos.com/api/v2/oauth2/token), ermittelt die Mandanten-ID des Aufrufers und den API-Host der Datenregion über whoami und sendet X-Tenant-ID (oder X-Organization-ID/X-Partner-ID für diese Anmeldeinformationstypen) bei jeder weiteren Anfrage. Es muss keine Mandanten-ID manuell konfiguriert werden.

Installieren

npm ci && npm run build

Dann weisen Sie Ihren MCP-Client auf dist/entry.js:

{
  "mcpServers": {
    "sophos-central": {
      "command": "node",
      "args": ["/path/to/sophos-central-mcp/dist/entry.js"],
      "env": {
        "SOPHOS_CLIENT_ID": "...",
        "SOPHOS_CLIENT_SECRET": "..."
      }
    }
  }
}

Tools

Anmerkungen zur API-Oberfläche von Sophos

• Switch-API ist derzeit begrenzt. Die eigenen Postman-Beispiele des Herstellers decken nur MAC-Filter-Einstellungen und asynchrone Aufgabenstatus ab – kein separater Switch-Gerätebestands-Endpunkt ist zum Zeitpunkt der Erstellung dieses Textes dokumentiert.

• Endpoint-Wiederherstellung/Dateidurchsuchung und Firewall-Verkehrslogs werden von dieser API-Oberfläche überhaupt nicht abgedeckt; Sophos Centrals Konsole bleibt der Ort dafür.