Semgrep MCP Server

Der Semgrep MCP Server bringt die Sicherheitsprüfung von Semgrep direkt in Ihren KI-Coding-Agenten. Semgrep ist ein verbreitetes Werkzeug für statische Codeanalyse. Statische Analyse bedeutet, dass der Code untersucht wird, ohne ihn auszuführen. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude Code, Codex, Cursor oder GitHub Copilot externe Werkzeuge aufrufen. Der Server stammt von Semgrep selbst. Früher lag er in einem eigenen Repository, das seit Oktober 2025 archiviert ist. Laut Anbieter wird er seitdem als Teil der offiziellen Semgrep CLI weiterentwickelt, deren Quellcode unter der LGPL-2.1 steht.

Wofür ist der Semgrep MCP Server nützlich?

KI-Agenten schreiben in kurzer Zeit viel Code. Dabei rutschen leicht typische Fehler durch: eine SQL-Abfrage aus zusammengesetzten Strings, ein fest eingetragener API-Schlüssel oder ein Paket in einer Version mit bekannter Sicherheitslücke. Normalerweise fallen solche Probleme erst in der CI auf, also nach dem Push, oder im Code-Review. Der Semgrep MCP Server setzt früher an. Der Agent prüft seinen eigenen Code noch während er ihn schreibt. Findet Semgrep ein Problem, bekommt der Agent den Befund zurück und kann den Code sofort neu erzeugen. Der neue Code wird erneut geprüft. Laut Dokumentation schreibt Semgrep dabei selbst nichts um, sondern liefert nur die Befunde. Die Entscheidung bleibt beim Agenten und bei Ihnen.

Was wird geprüft?

Semgrep deckt laut Anbieter drei Bereiche ab. Semgrep Code sucht nach verwundbaren Mustern im Quelltext, etwa Injection-Lücken oder unsichere Kryptografie. Supply Chain prüft Abhängigkeiten auf bekannte Schwachstellen. Dazu kommen Regeln, die fest eingetragene Zugangsdaten erkennen. Diese Secrets-Erkennung arbeitet mit Code-Regeln und prüft nicht, ob ein gefundener Schlüssel noch gültig ist. Für die vollständige Secrets-Prüfung empfiehlt Semgrep weiterhin das eigene Produkt in der CI.

Guardian: das Plugin für Claude Code und Codex

Für Claude Code und Codex empfiehlt Semgrep das Plugin Semgrep Guardian. Es bündelt den MCP-Server mit Hooks und Skills. Ein Hook ist ein Befehl, den der Agent automatisch bei einem bestimmten Ereignis ausführt. In Claude Code registriert Guardian einen Hook nach jedem Schreibvorgang, sodass jede neu geschriebene Datei geprüft wird, ohne dass Sie daran denken müssen. Das Plugin nutzt einen von Semgrep gehosteten Server, eine lokale Installation der CLI ist nicht nötig. Die Anmeldung erfolgt einmalig im Browser. Wichtig: Das Remote-Plugin verwendet ein festes Regelset namens guardian-default. Es basiert auf dem Standardregelset von Semgrep und enthält laut Dokumentation nur Regeln, für die der Agent eine verlässliche Korrektur umsetzen kann. Eigene Policies Ihrer Organisation greifen hier nicht.

Lokale Variante über die Semgrep CLI

Für alle anderen Agenten läuft der Server lokal über die Semgrep CLI mit dem Befehl semgrep mcp. Unterstützt sind laut Dokumentation unter anderem Cursor, GitHub Copilot in VS Code, Visual Studio und JetBrains, Devin beziehungsweise Windsurf und Kiro. Der Agent ruft dann das Werkzeug semgrep_scan auf. In dieser Variante gelten die Regeln aus den Policies Ihrer Semgrep-Organisation. Wer seine Regeln bereits angepasst hat, bekommt so im Agenten dieselben Ergebnisse wie in der Pipeline. Auch für Claude Code gibt es ein lokales Plugin, das statt des gehosteten Servers die lokale CLI nutzt.

Was unterscheidet Semgrep von Alternativen?

Viele Sicherheitsscanner laufen nur in der CI oder als nachgelagerter Dienst. Semgrep setzt beim Schreiben an und gibt die Befunde in einer Form zurück, mit der ein Agent arbeiten kann. Die Regeln sehen aus wie der zu prüfende Code und sind dadurch auch für Entwickler ohne Sicherheitshintergrund lesbar. Im Katalog ergänzt Semgrep den GitGuardian MCP Server, der sich auf Secrets konzentriert, um die breitere Prüfung von Codemustern und Abhängigkeiten.

Für wen lohnt sich der Semgrep MCP Server?

Der Server lohnt sich für Teams, die viel Code mit KI-Agenten erzeugen und Sicherheitsprobleme früh abfangen wollen. Wer Semgrep bereits in der Pipeline nutzt, verbindet über die lokale Variante dieselben Policies mit dem Agenten. Einzelentwickler starten am schnellsten mit dem Guardian-Plugin. Guardian ersetzt die CI-Prüfung nicht, sondern ergänzt sie, das betont Semgrep ausdrücklich. Zu den Kosten: Die Semgrep CLI ist Open Source. Die Plattform bietet laut Preisseite einen kostenlosen Plan für kleine Teams sowie kostenpflichtige Teams- und Enterprise-Pläne. Guardian lässt sich 30 Tage ohne Kreditkarte testen und ist danach kostenpflichtig pro Seat.

Ein Semgrep-Konto. Für das Guardian-Plugin Claude Code oder die Codex CLI; für die lokale Variante zusätzlich die Semgrep CLI (Python 3.10 oder neuer, Installation per pipx, uv oder Homebrew) mit Anmeldung über semgrep login.

Der Semgrep MCP Server prüft Code, den Ihr KI-Agent schreibt, auf Sicherheitsprobleme. Dieser Ratgeber zeigt die beiden Wege, ihn einzurichten, und worauf Sie danach achten sollten.

Den passenden Weg wählen

Semgrep bietet zwei Varianten. Das Guardian-Plugin für Claude Code und Codex nutzt einen gehosteten Server und braucht keine lokale Installation. Es prüft mit dem festen Regelset guardian-default. Die lokale Variante läuft über die Semgrep CLI und nutzt die Policies Ihrer Semgrep-Organisation. Sie ist der Weg für Cursor, VS Code, GitHub Copilot, Windsurf und Kiro. Haben Sie Ihre Regeln bereits angepasst, wählen Sie die lokale Variante.

Schritt 1: Guardian in Claude Code installieren

Führen Sie claude plugin install semgrep@claude-plugins-official aus. Starten Sie danach mit claude eine neue Sitzung. Claude Code fordert Sie auf, sich im Browser bei Semgrep anzumelden oder ein Konto anzulegen. Das ist eine einmalige Anmeldung. Ob der Server verbunden ist, sehen Sie mit claude mcp get plugin:semgrep:guardian. Ab jetzt wird jede Datei geprüft, die Claude schreibt.

claude plugin install semgrep@claude-plugins-official
claude mcp get plugin:semgrep:guardian

Schritt 2: Guardian in Codex installieren

Fügen Sie zuerst den Marktplatz hinzu: codex plugin marketplace add https://github.com/semgrep/guardian --sparse .claude-plugin --sparse plugin. Installieren Sie dann das Plugin mit codex plugin add semgrep@semgrep-marketplace. Starten Sie Codex neu und schreiben Sie: Log in to Semgrep Guardian. Nach der Anmeldung im Browser prüfen Sie die Installation mit codex plugin list --json. Codex fragt Sie, ob Sie den Hooks vertrauen. Erst nach Ihrer Zustimmung laufen die Scans nach Schreibvorgängen.

codex plugin marketplace add https://github.com/semgrep/guardian --sparse .claude-plugin --sparse plugin
codex plugin add semgrep@semgrep-marketplace
codex plugin list --json

Schritt 3: Lokale Variante für Cursor und VS Code

Installieren Sie die Semgrep CLI, laut Dokumentation am besten mit pipx install semgrep oder uv tool install semgrep. Sie brauchen Python 3.10 oder neuer. Melden Sie sich mit semgrep login an. In VS Code legen Sie die Datei .vscode/mcp.json an, mit einem Server namens semgrep, dem Befehl semgrep und dem Argument mcp. Nach dem Neuladen stehen die Semgrep-Werkzeuge im Agent-Modus von Copilot Chat bereit. VS Code hat keinen Hook nach dem Schreiben. Der Agent prüft deshalb nur, wenn er das Werkzeug aufruft. Bitten Sie ihn darum ausdrücklich. In Cursor installieren Sie Semgrep aus dem Plugin-Marktplatz, dort kommen Hooks mit.

pipx install semgrep
uv tool install semgrep

Befunde richtig einordnen

Semgrep schreibt selbst keinen Code um. Es meldet Befunde, und der Agent entscheidet, ob er den Code neu erzeugt. Der neue Code wird erneut geprüft. Ein sauberer Scan heißt aber nicht, dass der Code sicher ist. Das Regelset guardian-default ist bewusst klein gehalten. Lassen Sie Semgrep deshalb weiter in der CI laufen.

PHP-Hinweis beim ersten Schreiben

Das Plugin für Claude Code und Codex prüft einmal pro Sitzung die lokale PHP-Version. Hat sie aktiv ausgenutzte Sicherheitslücken, blockiert Guardian den ersten Schreibbefehl und nennt die passende Version für das Update. Ist kein PHP installiert, wird die Prüfung übersprungen.

Guardian-Plugin: OAuth mit einmaliger Anmeldung im Browser, Zugangsdaten in ~/.semgrep/guardian.yml, Tokens werden automatisch erneuert. Lokale Variante: semgrep login, Zugangsdaten in ~/.semgrep/settings.yml. Sind OAuth-Daten vorhanden, haben sie laut Dokumentation Vorrang vor einem API-Token.

Liest die Dateien, die der Agent schreibt oder bearbeitet, und gibt Befunde zurück. Laut Dokumentation verändert Semgrep selbst keinen Code. Das Claude-Code- und Codex-Plugin führt zusätzlich einmal pro Sitzung php -v aus und blockiert bei einer PHP-Version mit aktiv ausgenutzten Lücken den ersten Schreibbefehl.

Das Guardian-Plugin für Claude Code und Codex nutzt einen von Semgrep gehosteten Scanner; der zu prüfende Code wird dafür an Semgrep übertragen. Die lokale Variante scannt mit der Semgrep CLI auf dem eigenen Rechner und lädt die Regeln aus den Policies der Organisation.

Gering, da der Server nur prüft und nichts verändert. Zu beachten: Beim Remote-Plugin verlässt Code den eigenen Rechner. Ein sauberer Scan bedeutet nicht, dass der Code sicher ist; das Regelset guardian-default ist bewusst eingeschränkt. Die Prüfung in der CI sollte deshalb bestehen bleiben.