
agent-scan v0.5.16
Sicherheitsscanner für KI-Agenten, MCP-Server und Agenten-Fähigkeiten.
Snyk Agent Scan
Entdecken und scannen Sie Agent-Komponenten auf Ihrem Rechner auf Prompt-Injections
und Schwachstellen (einschließlich Agents, MCP-Servern, Skills).
Hinweis: Wir veröffentlichen kein npm-Paket für Agent Scan. Installieren Sie es über
uvxoder als eigenständige Binärdatei.
Hinweis: Die CLI-Ausgabe ist experimentell und kann sich ändern
Agent Scan v0.5.x (Einstellung geplant)
Die Rohausgabe dieser CLI – einschließlich Issue-Codes, Feldnamen, Schweregradbezeichnungen und Antwortstruktur – ist experimentell und kann sich zwischen Releases ohne Vorankündigung ändern. Wir empfehlen nicht, Produktions-Workflows zu erstellen, die von bestimmten CLI-Ausgabefeldern oder Issue-Codes abhängen.
Agent Scan v0.6 und später
Die Rohausgabe dieser CLI – einschließlich Namen von Risikoindikatoren, Scores, Feldnamen und Antwortstruktur – ist experimentell und kann sich zwischen Releases ohne Vorankündigung ändern. Wir empfehlen nicht, Produktions-Workflows zu erstellen, die von bestimmten CLI-Ausgabefeldern oder Risikonamen abhängen.
Wenn Sie ein Enterprise-Kunde sind, der Snyk zur Verwaltung von Agent-Sicherheitsrisiken im großen Maßstab einsetzt, spiegelt die CLI-Ausgabe möglicherweise nicht wider, was an die Evo-Plattform gesendet und dort angezeigt wird. Die zugrunde liegende Integration, Discovery und Risikobewertung, die Enterprise-Bereitstellungen antreibt, ist stabil und unterstützt – Änderungen werden gemäß den standardmäßigen Snyk-Produktpraktiken kommuniziert. Wenden Sie sich an Ihr Account-Team, um Hinweise zur Bereitstellung zu erhalten.
NEU Lesen Sie unseren technischen Bericht über die aufkommenden Bedrohungen des Agent-Skill-Ökosystems, der zusammen mit Agent Scan 0.4 veröffentlicht wurde und Unterstützung für das Scannen von Agent-Skills hinzufügt.
Ausgabe von Agent Scan v0.5.x
[!WARNING] Agent Scan v0.5.x verwendet eine Issue-Code-Ausgabe. Diese CLI-Version ist zur Einstellung geplant.
Ausgabe von Agent Scan v0.6 und später
Agent Scan hilft Ihnen, alle installierten Agent-Komponenten (Harnesses, MCP-Server und Skills) zu entdecken, und scannt sie auf gängige Bedrohungen wie Prompt-Injections, den Umgang mit sensiblen Daten oder in natürlicher Sprache verborgene Malware-Payloads. Ignorieren Sie die Analyse von Skills mit --no-skills.
Sicherheitswarnung
⚠️ WICHTIG: Das Scannen von MCP-Konfigurationen kann Befehle ausführen oder ausgehende Netzwerkanfragen stellen.
Um Tool-Beschreibungen abzurufen, startet Agent Scan stdio-MCP-Server, indem es die Befehle in der Konfiguration ausführt, und verbindet sich mit konfigurierten Remote-MCP-Server-URLs unter Verwendung ihrer konfigurierten Header.
Empfehlungen:
- Führen Sie Scans in einer Sandbox aus (Docker-Container, VM oder Wegwerf-Umgebung), wenn Sie nicht vertrauenswürdige oder MCP-Konfigurationen von Drittanbietern bewerten
- Prüfen Sie die Zustimmungsaufforderung sorgfältig bei interaktiven Scans; sie zeigt den Befehl oder die Remote-URL für jeden Server an
- Verwenden Sie
--dangerously-run-mcp-serversnur in vertrauenswürdigen Umgebungen, in denen Sie alle MCP-Server-Befehle und Remote-URLs überprüft habenRemote-MCP-Anfragen lehnen Ziele ab, die sich zu Link-Local-Adressen oder bekannten Cloud-Metadaten-Endpunkten auflösen (
169.254.0.0/16,fe80::/10,fd00:ec2::254und100.100.100.200). Loopback- und private Adressen bleiben für lokale und interne MCP-Server zulässig. HTTP-Weiterleitungen werden nicht verfolgt. DNS wird vor jeder Anfrage validiert, aber die erneute Auflösung zum Verbindungszeitpunkt hinterlässt ein DNS-Rebinding-Fenster.Standardmäßig verlangt Agent Scan bei interaktiven Vordergrundläufen eine ausdrückliche Benutzerzustimmung (j/n), bevor jeder entdeckte MCP-Server kontaktiert wird. Hintergrund- und Push-Key-Scans inspizieren Remote-Server weiterhin automatisch für die Flottenabdeckung, starten aber keine stdio-Server, es sei denn,
--dangerously-run-mcp-serversist gesetzt.
Schnellstart
Wählen Sie eine von zwei Möglichkeiten, Agent Scan auszuführen:
- Führen Sie das Python-Paket mit
uvxaus gemäß den folgenden Anweisungen. - Laden Sie eine eigenständige Binärdatei für Ihre Plattform von GitHub Releases herunter. Die Releases enthalten außerdem die SBOM, Prüfsummen, signierte Prüfsummen und Quellcode-Archive.
Bevor Sie eine der beiden Optionen verwenden:
- Registrieren Sie sich bei Snyk und holen Sie sich ein API-Token von https://app.snyk.io/account (API Token → KEY → zum Anzeigen klicken).
- Legen Sie das Token als Umgebungsvariable fest, bevor Sie einen Scan ausführen:
export SNYK_TOKEN=your-api-token-here
Ausführen mit uvx
uv muss auf Ihrem System installiert sein. Wählen Sie die Anweisungen für Ihre CLI-Version.
Agent Scan v0.5.x
Die Beispiele legen v0.5.17 als konkrete v0.5.x-Version fest:
# Scan the whole machine
uvx [email protected]
# Scan a specific MCP configuration
uvx [email protected] ~/.vscode/mcp.json
# Scan a single agent skill
uvx [email protected] ~/path/to/my/SKILL.md
# Scan all Claude skills
uvx [email protected] ~/.claude/skills
[!WARNING] v0.5.x verwendet die Issue-Code-Ausgabe und die Analyse-API
2025-09-02. Diese CLI-Linie ist zur Einstellung vorgesehen.
Agent Scan v0.6 und später
# Scan the whole machine
uvx snyk-agent-scan@latest
# Scan a specific MCP configuration
uvx snyk-agent-scan@latest ~/.vscode/mcp.json
# Scan a single agent skill
uvx snyk-agent-scan@latest ~/path/to/my/SKILL.md
# Scan all Claude skills
uvx snyk-agent-scan@latest ~/.claude/skills
v0.6 und später verwenden die risikobasierte Ausgabe und die Analyse-API 2026-07-10.
Beide Versionen scannen MCP-Server, Tools, Prompts, Ressourcen und Skills und entdecken automatisch unterstützte Agent-Konfigurationen wie Claude Code/Desktop, Cursor, Gemini CLI und Windsurf.
Ausführen mit einer eigenständigen Binärdatei
Laden Sie die Binärdatei für Ihr Betriebssystem und Ihre Architektur aus dem neuesten GitHub-Release herunter. Die Release-Seite bietet außerdem eine SBOM (sbom-<version>.json), Prüfsummendateien und von GitHub generierte Quellcode-Archive. Informationen zur Überprüfung Ihres Downloads finden Sie unter Verifying Standalone Binaries.
Highlights
- Automatische Erkennung von MCP-Konfigurationen, Agent-Tools, Skills
- Scannen von Claude, Cursor, GitHub Copilot, Windsurf, Gemini CLI, Amp, Amazon Q und anderen Agents.