MCP-сервер FraudLabs Pro

Name: mcp-fraudlabspro
Author: fraudlabspro

MCP-совместимый сервер, который интегрирует систему обнаружения мошенничества FraudLabs Pro в ИИ-ассистенты, такие как Claude Desktop. Этот сервер позволяет в режиме реального времени проверять транзакции заказов и события, связанные с пользователями (например, входы в систему или регистрации), для выявления и предотвращения мошеннических действий.

Функции

Проверка заказов: проверка заказов в электронной коммерции с использованием IP-адресов, платежных/доставных данных и информации о кредитных картах.
Проверка пользователей: анализ событий на уровне учетной записи (регистрации/входы в систему) на предмет подозрительных шаблонов.
Управление транзакциями: получение исторических результатов для заказов или проверок пользователей.
Обратная связь: одобрение, отклонение или внесение транзакций в черный список непосредственно через интерфейс ИИ для улучшения механизма обнаружения.

Предварительные требования

Установленный Python 3.10+.
API-ключ FraudLabs Pro: вы можете получить бесплатный или платный API-ключ на сайте FraudLabs Pro.

Установка

Установка зависимостей Убедитесь, что в вашей среде установлены необходимые библиотеки:

pip install mcp httpx

Конфигурация Чтобы использовать этот сервер с MCP-клиентом (например, Claude Desktop), добавьте следующую запись в ваш файл конфигурации:

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

Доступные инструменты

📦 Управление заказами

Инструмент	Описание	Ключевые аргументы
screen_order	Проверка заказа на мошенничество.	ip, email, amount, bin_no, bill_country, ship_country
get_order_result	Получение результата проверки для предыдущего заказа.	transaction_id
feedback_order	Обновление статуса заказа (APPROVE, REJECT, BLACKLIST).	transaction_id, action, note

👤 Управление пользователями

Инструмент	Описание	Ключевые аргументы
screen_user	Проверка событий пользователя, таких как входы или регистрации.	email, ip, phone, first_name, last_name
get_user_result	Получение результатов для предыдущей проверки пользователя.	user_transaction_id
feedback_user	Обновление статуса события пользователя на основе ручной проверки.	user_transaction_id, action, reason

Разработка и логирование

Сервер использует FastMCP и отправляет логи через контекст MCP. Вы можете просматривать логи в «Консоли разработчика» (Developer Console) Claude Desktop для проверки исходящих полезных нагрузок и ответов API при отладке.

Распространенная ошибка: если вы получаете сообщение «An API key is needed» (Требуется API-ключ), убедитесь, что переменная среды FRAUDLABSPRO_API_KEY правильно установлена в вашем файле конфигурации и что вы перезапустили MCP-клиент.