agent-opfor

Open-Source-Adversary-Emulation für KI-Agenten, LLM-Apps und MCP-Server.
Teste deine KI wie ein echter Angreifer – von deiner CLI, deiner IDE oder einer Browser-Erweiterung, die jedes Teammitglied nutzen kann.

Website · Dokumentation · GitHub · Browser-Erweiterung · Discord

OPFOR steht für Opposition Force – ein militärischer Begriff für die Einheit, die im Training den Feind spielt, damit der Rest der Armee lernt, wie sich echte Angriffe anfühlen, bevor sie kommen. Wir haben das Tool nach dieser Idee benannt: Um KI-Agenten besser zu verteidigen, muss man sie zuerst angreifen.

Warum wir das gebaut haben

Wir haben in den letzten zehn Jahren 130 Produkte für 90 Startups ausgeliefert. In den letzten 18 Monaten enthielt fast jedes davon einen KI-Agenten – und jedes dieser Teams stieß beim Testen auf dieselbe Wand.

Also haben wir OPFOR gebaut. Zuerst für uns selbst. Jetzt Open Source.

Apache 2.0. Gebaut in Indien.

Schnellstart

npm install -g @keyvaluesystems/agent-opfor-cli
export OPENAI_API_KEY=dein-key    # oder GEMINI_API_KEY, ANTHROPIC_API_KEY, etc.

Ein-Schritt – führt den Setup-Assistenten aus und startet sofort den Scan:

opfor run

Zwei-Schritte – speichert eine Konfiguration, die du wiederverwenden oder in CI einchecken kannst:

opfor setup                               # Assistent speichert Konfiguration in .opfor/configs/
opfor run --config .opfor/configs/<datei>  # jederzeit mit der gespeicherten Konfiguration ausführen

https://github.com/user-attachments/assets/a6a3cff2-2cf9-4486-944e-ac0163e7ea04

Was opfor macht

Opfor testet die gesamte KI-Agenten-Oberfläche – Prompts, Tools, MCP-Server, Speicher und mehrschrittige Argumentation. Es generiert gezielte Angriffe für OWASP LLM Top 10, OWASP Agentic AI Top 10, OWASP MCP Top 10, OWASP API Security und EU AI Act Bias-Suites, feuert sie auf dein Ziel und bewertet jede Antwort mit einem LLM.

Die meisten Red-Team-Tools in diesem Bereich sind hervorragend in einer Sache – einer Probe-Bibliothek, einem Entwickler-Evaluator, einem programmatischen Framework. Opfor deckt in einem Tool mehr ab:

• Browser-Erweiterung für Nicht-Entwickler – jedes Teammitglied kann einen bereitgestellten Chatbot testen, kein Code, keine Umgebungsvariablen, kein YAML
• Opfor als MCP-Server ausführen – lass deinen KI-Coding-Agenten in Cursor oder Claude Desktop deine anderen Agenten per natürlicher Sprache testen
• Vollständige OWASP-Abdeckung in einem Tool – LLM Top 10, Agentic AI Top 10, MCP Top 10, API Security Top 10
• Keine Blackbox – jeder Angriffs-Prompt, jede Anfrage, jede Antwort und jedes Richterurteil wird protokolliert; reproduzierbar, auditierbar, forkbar
• Für Agenten entwickelt, nicht nur für Modelle – von Anfang an für Tool-Aufrufe, MCP, Speicher und mehrschrittigen Zustand ausgelegt
• Trace-bewusst – integriert mit Langfuse und Netra, sodass der LLM-Richter sieht, was dein Agent intern getan hat, nicht nur, was er gesagt hat

Fünf Wege, opfor auszuführen

Verschiedene Personen in deinem Team benötigen unterschiedliche Einstiegspunkte. Opfor liefert fünf.

Modus	Wie	Am besten für
🖥️ CLI	opfor setup → opfor run	Entwickler, CI/CD, terminal-zentrierte Workflows
🌐 Browser-Erweiterung	Erweiterung installieren, auf einer beliebigen Chat-Oberfläche auf das opfor-Symbol klicken	Produktmanager, Designer, QA, Sicherheitsanalysten – alle, die keinen Code schreiben können oder wollen
🤖 MCP-Server	Opfor in Cursor oder Claude Desktop registrieren, dann im Chat fragen	KI-Coding-Agenten, die deine anderen Agenten testen
⚡ Skills	/opfor-setup · /opfor-run · /opfor-mcp-setup · /opfor-mcp-run	Entwickler, die Ein-Kommando-Tests in ihrer IDE wünschen
📦 SDK	npm install @keyvaluesystems/agent-opfor-sdk, dann run / hunt aus dem Code aufrufen	Programmatisches Red-Teaming und benutzerdefinierte Workflows

Alle fünf teilen sich die gleichen Evaluatoren, Angriffsvorlagen und Richterlogik.

→ CLI-Referenz · Browser-Erweiterung einrichten · MCP einrichten · Skills einrichten · SDK-Referenz · Sitzungsverwaltung

So funktioniert es

Wenn du einen Scan ausführst, macht opfor: