Servidor MCP de FraudLabs Pro

Name: mcp-fraudlabspro
Author: fraudlabspro

Un servidor compatible con MCP que integra el sistema de detección de fraude de FraudLabs Pro en asistentes de IA como Claude Desktop. Este servidor permite el análisis en tiempo real de transacciones de pedidos y eventos relacionados con usuarios (como inicios de sesión o registros) para identificar y prevenir actividades fraudulentas.

Características

Análisis de pedidos: Valide pedidos de comercio electrónico utilizando direcciones IP, detalles de facturación/envío e información de tarjetas de crédito.
Análisis de usuarios: Analice eventos a nivel de cuenta (registros/inicios de sesión) en busca de patrones sospechosos.
Gestión de transacciones: Recupere resultados históricos de pedidos o análisis de usuarios.
Bucle de retroalimentación: Apruebe, rechace o incluya en listas negras transacciones directamente a través de la interfaz de IA para mejorar el motor de detección.

Requisitos previos

Python 3.10+ instalado.
Clave de API de FraudLabs Pro: Puede obtener una clave de API gratuita o de pago en FraudLabs Pro.

Instalación

Instalar dependencias Asegúrese de tener las bibliotecas necesarias instaladas en su entorno:

pip install mcp httpx

Configuración Para utilizar este servidor con un cliente MCP (como Claude Desktop), añada la siguiente entrada a su archivo de configuración:

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"
      }
    }
  }
}

Herramientas disponibles

📦 Gestión de pedidos

Herramienta	Descripción	Argumentos clave
screen_order	Analizar un pedido en busca de fraude.	ip, email, amount, bin_no, bill_country, ship_country
get_order_result	Recuperar el resultado de validación de un pedido anterior.	transaction_id
feedback_order	Actualizar el estado del pedido (APPROVE, REJECT, BLACKLIST).	transaction_id, action, note

👤 Gestión de usuarios

Herramienta	Descripción	Argumentos clave
screen_user	Analizar eventos de usuario como inicios de sesión o registros.	email, ip, phone, first_name, last_name
get_user_result	Recuperar resultados de un análisis de usuario anterior.	user_transaction_id
feedback_user	Actualizar el estado del evento de usuario según una revisión manual.	user_transaction_id, action, reason

Desarrollo y registro

El servidor utiliza FastMCP y envía registros a través del contexto MCP. Puede ver los registros en la "Consola de desarrollador" de Claude Desktop para inspeccionar las cargas útiles salientes y las respuestas de la API para la depuración.

Error común: Si recibe "An API key is needed", asegúrese de que la variable de entorno FRAUDLABSPRO_API_KEY esté configurada correctamente en su archivo de configuración y que haya reiniciado el cliente MCP.