keyvaluesoftwaresystems/agent-opforOpen-Source-Angreifer-Emulation für KI-Agenten und MCP-Server.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/Opfor_white%20text.svg" />
<source media="(prefers-color-scheme: light)" srcset="assets/Opfor_black%20text.svg" />
<img src="https://raw.githubusercontent.com/keyvaluesoftwaresystems/agent-opfor/HEAD/assets/Opfor_black%20text.svg" alt="OPFOR" width="250" />
</picture>
</p>
<p align="center">
<strong>Open-Source-Adversary-Emulation für KI-Agenten, LLM-Apps und MCP-Server.</strong><br/>
Teste deine KI wie ein echter Angreifer – von deiner CLI, deiner IDE oder einer Browser-Erweiterung, die jedes Teammitglied nutzen kann.
</p>
<p align="center">
<a href="https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-Apache_2.0-444441?style=flat&labelColor=3d3d3a" alt="License: Apache 2.0"></a>
<a href="https://github.com/KeyValueSoftwareSystems/agent-opfor/stargazers"><img src="https://img.shields.io/github/stars/KeyValueSoftwareSystems/agent-opfor?style=flat&labelColor=3d3d3a&color=444441" alt="GitHub stars"></a>
<a href="https://discord.gg/Sb8xfmrjjW"><img src="https://img.shields.io/badge/Discord-join-5865F2?style=flat&logo=discord&logoColor=white&labelColor=3d3d3a" alt="Discord"></a>
<a href="#evaluator-coverage"><img src="https://img.shields.io/badge/OWASP-LLM%20+%20Agentic%20+%20MCP%20+%20API-185FA5?style=flat&labelColor=3d3d3a" alt="OWASP coverage"></a>
</p>
<p align="center">
<a href="https://trendshift.io/repositories/75655?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-75655" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/75655/daily?language=TypeScript" alt="KeyValueSoftwareSystems%2Fagent-opfor | Trendshift" width="250" height="55"/></a>
</p>
<p align="center">
<a href="https://agentopfor.ai/">Website</a> ·
<a href="https://docs.agentopfor.ai">Dokumentation</a> ·
<a href="https://github.com/KeyValueSoftwareSystems/agent-opfor">GitHub</a> ·
<a href="https://chromewebstore.google.com/detail/blkflfeicejfnbecanjaolbllmoobenp">Browser-Erweiterung</a> ·
<a href="https://discord.gg/Sb8xfmrjjW">Discord</a>
</p>
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.
<p align="center">
<img src="https://raw.githubusercontent.com/keyvaluesoftwaresystems/agent-opfor/HEAD/assets/opfor-high-level.svg" alt="Wie OPFOR funktioniert" width="860" />
</p>
## 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
```bash
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:
```bash
opfor run
```
**Zwei-Schritte** – speichert eine Konfiguration, die du wiederverwenden oder in CI einchecken kannst:
```bash
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](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/cli.md) · [Browser-Erweiterung einrichten](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/browser-extension.md) · [MCP einrichten](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/mcp.md) · [Skills einrichten](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/skills.md) · [SDK-Referenz](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/sdk.md) · [Sitzungsverwaltung](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/sessions.md)
## So funktioniert es
<p align="center">
<img src="https://raw.githubusercontent.com/keyvaluesoftwaresystems/agent-opfor/HEAD/assets/opfor-execution-flow.svg" alt="Was bei opfor run passiert" width="860" />
</p>
Wenn du einen Scan ausführst, macht opfor:
1. **Zielinformationen abrufen** – verbindet sich mit deinem Agenten, erkennt verfügbare Tools, MCP-Endpunkte, Fähigkeiten
2. **Angriffe pro Kategorie planen** – generiert zielgerichtete Prompts für jeden Evaluator in deiner ausgewählten Suite
3. **Den Angriff emulieren** – führt mehrschrittige adversariale Gespräche (echte Anfragen, echte Antworten)
4. **Mit einem Richter bewerten** – ein LLM-Richter klassifiziert jede Antwort mit bestanden/nicht bestanden + Begründung
5. **Einen Bericht erstellen** – HTML zum Durchsuchen, JSON für CI/CD, alle Artefakte werden für Reproduzierbarkeit protokolliert
Jeder Lauf landet in einem eigenen Unterordner unter `.opfor/reports/run-report-<compactTs>-<slug>-<shortId>/` mit `<slug>-report.html` und `<slug>-report.json`. Autonome `opfor hunt`-Läufe verwenden das gleiche Layout unter `hunt-report-<compactTs>-<slug>-<shortId>/`.
## Evaluator-Abdeckung
Opfor wird mit kuratierten Suiten ausgeliefert, die auf Industriestandards abbilden. Wähle eine Suite oder führe einzelne Evaluatoren aus.
| Suite-ID | Standard | Fokus |
| ------------------ | ------------------------- | ------------------------------------------------------------------------- |
| `owasp-llm-top10` | OWASP LLM Top 10 (2025) | Prompt-Injection, Jailbreaks, Offenlegung sensibler Daten, System-Prompt-Leakage |
| `owasp-agentic-ai` | OWASP Agentic AI Top 10 | Übermäßige Handlungsfähigkeit, Tool-Missbrauch, Agent-Ziel-Entführung, Speichervergiftung |
| `owasp-mcp-top10` | OWASP MCP Top 10 (2025) | Geheimnis-Offenlegung, Bereichseskalation, Tool-Beschreibungs-Injection, SSRF |
| `owasp-api` | OWASP API Security Top 10 | BOLA, BFLA, SQL-Injection |
| `eu-ai-act-bias` | EU AI Act – Bias | Alter, Geschlecht, Ethnie, Behinderung |
→ [Vollständige Evaluator-Referenz und OWASP-Zuordnung](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/evaluators.md)
## Trace-bewusstes Testen
Stecke opfor in deinen Observability-Stack und der LLM-Richter sieht nicht nur die endgültige Antwort – sondern jeden Tool-Aufruf, jede Abfrage und jeden Zwischenschritt der Argumentation. Out of the Box integriert opfor mit **[Langfuse](https://langfuse.com)** und **[Netra](https://getnetra.ai)**.
```json
"telemetry": {
"provider": "langfuse",
"langfuse": { "baseUrl": "https://cloud.langfuse.com" }
}
```
Dies fängt ein, was Input/Output-Tests übersehen – PII, die in einen Tool-Aufruf gelangt, aber nie den Nutzer erreicht, Bereichseskalationen in MCP, die den Antworttext nicht ändern, Agenten, die unbefugte Daten abrufen, aber eine saubere Antwort liefern.
→ [Leitfaden zum Trace-bewussten Testen](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/telemetry.md)
## Autonomes Red-Teaming
`opfor hunt` überspringt die Konfigurationsdatei vollständig. Gib einen Endpunkt und ein Ziel vor, und ein Multi-Agenten-System – Kommandant, Operateure, Späher – führt eine eigene adaptive Angriffskampagne durch: Aufklärung, Strategie, mehrschrittiges Sondieren, Bericht. Im Gegensatz zu `opfor run` laufen die Agenten nur auf Claude (über einen Claude-API-Key, `claude setup-token` oder deine lokale `claude login`-Sitzung) – dein Ziel kann alles sein.
```bash
opfor hunt \
--endpoint "https://your-agent.com/v1/chat" \
--objective "Finde Jailbreaks, System-Prompt-Leakage und Sicherheitsumgehungen."
```
Füge `--ui` hinzu, um den Angriffsbaum in einem Live-Dashboard zu beobachten.
→ [Vollständige Referenz](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/hunt.md)
## Browser-Erweiterung – einen Chatbot red-teamen
Die Browser-Erweiterung ist opfors codefreier Pfad. Installiere sie aus dem Chrome Web Store, öffne eine beliebige Chat-Oberfläche, klicke auf das opfor-Symbol, wähle eine Suite und sieh zu, wie sie läuft.
https://github.com/user-attachments/assets/80c2692f-b18b-4899-99df-e7eb8d50b02a
Sie erkennt automatisch die Chat-Oberfläche, sendet Angriffs-Prompts als ob du sie tippen würdest, beobachtet die Antworten und lädt einen HTML-Bericht herunter, wenn sie fertig ist. Kein CLI, keine Zieleinrichtung, kein YAML.
Dies ist der Pfad für die Hälfte jedes Produktteams, die kein Terminal öffnet.
→ [Aus dem Chrome Web Store installieren](https://chromewebstore.google.com/detail/blkflfeicejfnbecanjaolbllmoobenp) · [Einrichtungsanleitung](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/browser-extension.md)
## SDK – Red-Teaming in deinen Code einbetten
Das SDK ist opfors programmatischer Pfad. Installiere `@keyvaluesystems/agent-opfor-sdk`, rufe `run` oder `hunt` auf und erhalte strukturierte Ergebnisse zurück – kein CLI, keine Konfigurationsdateien, keine Unterprozesse.
```typescript
import { Opfor } from "@keyvaluesystems/agent-opfor-sdk";
const opfor = new Opfor({ apiKey: process.env.ANTHROPIC_API_KEY });
const results = await opfor.run({
target: { url: "https://api.example.com/chat" },
suite: "owasp-llm-top10",
});
```
Verwende es in CI, in Test-Suiten oder überall, wo Red-Teaming nötig ist, ohne TypeScript zu verlassen.
→ [SDK-Referenz](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/docs/sdk.md)
## Beispiele
| Beispiel | Beschreibung |
| ----------------------------------------------------- | --------------------------------------------------------------- |
| [vanilla-chat](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/tests/e2e/agents/vanilla-chat) | Einfacher Kundensupport-Chatbot – Teste LLM-Level-Schwachstellen |
| [customer-support](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/tests/e2e/agents/customer-support) | Tool-aufrufender Agent mit PostgreSQL – Teste BOLA, BFLA, RBAC, PII |
| [vulnerable-server](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/tests/e2e/mcp/vulnerable-server) | Beispiel-MCP-Server mit absichtlichen Schwachstellen |
## Unterstützte LLM-Anbieter
| Anbieter | Umgebungsvariable | Standardmodell |
| ----------------- | ------------------------------ | ---------------------------------- |
| Groq | `GROQ_API_KEY` | `llama-3.3-70b-versatile` |
| OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` |
| Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` |
| Google | `GOOGLE_GENERATIVE_AI_API_KEY` | `gemini-2.0-flash` |
| OpenAI-kompatibel | `OPFOR_API_KEY` + `baseURL` | LiteLLM, OpenRouter, Azure, Ollama |
## Mitwirken
Bitte lies [CONTRIBUTING.md](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/CONTRIBUTING.md) für Details zu unserem Verhaltenskodex und zum Prozess für Pull-Requests.
## Autoren
Entwickelt vom Team bei [KeyValue Software Systems](https://keyvalue.systems). Kontakt unter [[email protected]](mailto:[email protected]) für alle Anfragen.
## Sicherheit
Verwende opfor nur auf Systemen, die dir gehören oder für die du autorisiert bist. Um eine Sicherheitslücke in opfor selbst zu melden, siehe [SECURITY.md](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/SECURITY.md) – öffne kein öffentliches Issue.
## Lizenz
Opfor ist unter Apache 2.0 lizenziert – siehe die Datei [LICENSE](https://github.com/keyvaluesoftwaresystems/agent-opfor/blob/master/LICENSE) für Details.
---
<p align="center">
Mit ❤️ erstellt von <a href="https://keyvalue.systems">KeyValue</a>
</p>