FraudLabs Pro MCP-Server

Name: mcp-fraudlabspro
Author: fraudlabspro

Ein MCP-kompatibler Server, der das FraudLabs Pro Betrugserkennungssystem in KI-Assistenten wie Claude Desktop integriert. Dieser Server ermöglicht die Echtzeit-Überprüfung von Auftragstransaktionen und benutzerbezogenen Ereignissen (wie Anmeldungen oder Registrierungen), um betrügerische Aktivitäten zu identifizieren und zu verhindern.

Funktionen

Auftragsprüfung: Validierung von E-Commerce-Bestellungen unter Verwendung von IP-Adressen, Rechnungs-/Versanddetails und Kreditkarteninformationen.
Benutzerprüfung: Analyse von Ereignissen auf Kontoebene (Registrierungen/Anmeldungen) auf verdächtige Muster.
Transaktionsverwaltung: Abrufen historischer Ergebnisse für Bestellungen oder Benutzerüberprüfungen.
Feedback-Schleife: Genehmigen, Ablehnen oder Blacklisten von Transaktionen direkt über die KI-Schnittstelle, um die Erkennungs-Engine zu verbessern.

Voraussetzungen

Python 3.10+ installiert.
FraudLabs Pro API-Schlüssel: Sie können einen kostenlosen oder kostenpflichtigen API-Schlüssel unter FraudLabs Pro erhalten.

Installation

Abhängigkeiten installieren Stellen Sie sicher, dass die erforderlichen Bibliotheken in Ihrer Umgebung installiert sind:

pip install mcp httpx

Konfiguration Um diesen Server mit einem MCP-Client (wie Claude Desktop) zu verwenden, fügen Sie den folgenden Eintrag zu Ihrer Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fraudlabspro": {
      "command": "python3",
      "args": ["/absolute/path/to/the/src/server.py"],
      "env": {
        "FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Verfügbare Tools

📦 Auftragsverwaltung

Tool	Beschreibung	Wichtige Argumente
screen_order	Überprüfung einer Bestellung auf Betrug.	ip, email, amount, bin_no, bill_country, ship_country
get_order_result	Abrufen des Validierungsergebnisses für eine frühere Bestellung.	transaction_id
feedback_order	Aktualisierung des Bestellstatus (APPROVE, REJECT, BLACKLIST).	transaction_id, action, note

👤 Benutzerverwaltung

Tool	Beschreibung	Wichtige Argumente
screen_user	Überprüfung von Benutzerereignissen wie Anmeldungen oder Registrierungen.	email, ip, phone, first_name, last_name
get_user_result	Abrufen der Ergebnisse für eine frühere Benutzerüberprüfung.	user_transaction_id
feedback_user	Aktualisierung des Status von Benutzerereignissen basierend auf manueller Überprüfung.	user_transaction_id, action, reason

Entwicklung & Protokollierung

Der Server verwendet FastMCP und sendet Protokolle über den MCP-Kontext. Sie können Protokolle in der "Developer Console" von Claude Desktop einsehen, um ausgehende Payloads und API-Antworten zur Fehlerbehebung zu untersuchen.

Häufiger Fehler: Wenn Sie die Meldung "An API key is needed" erhalten, stellen Sie sicher, dass die Umgebungsvariable FRAUDLABSPRO_API_KEY in Ihrer Konfigurationsdatei korrekt gesetzt ist und Sie den MCP-Client neu gestartet haben.