payments-toolkit-mcp

Минимальный сервер Model Context Protocol (MCP), созданный как практический учебный проект (см. PLAN.md для полного пошагового руководства).

Он предоставляет утилиты проверки платежей в виде инструментов MCP и один статический ресурс — вся логика локальная, без сетевых вызовов и без необходимости в API-ключах.

Инструменты

• validate_card_number — проверка контрольной суммы Луна для номера карты (только цифры, длина 8-19).

• detect_card_type — определяет платёжную сеть (Visa, Mastercard, American Express, Discover, Diners Club, JCB) по префиксу IIN/BIN.

• validate_iban — проверка формата, длины для конкретной страны и контрольной суммы mod-97 по стандарту ISO 13616 для IBAN.

Related MCP server: stripe-mcp-server

Ресурсы

• card_networks (payments-toolkit://card-networks) — статический JSON-список поддерживаемых платёжных сетей и их диапазонов префиксов.

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

• Node.js 18+ (проект разрабатывался на v24)

• pnpm

Настройка

pnpm install
pnpm run build

Использование

Запустите сервер автономно (он ожидает ввода через stdio, так что это в основном для проверки работоспособности):

pnpm run start

Просматривайте и вызывайте инструменты/ресурсы напрямую через локальный веб-интерфейс, без подключения клиента:

pnpm run inspect

Подключение к Claude Code

claude mcp add payments-toolkit-mcp -- node /path/to/payments-toolkit-mcp/dist/index.js
claude mcp list

В сессии Claude Code выполните /mcp, чтобы подтвердить подключение и увидеть обнаруженные инструменты/ресурсы.

Структура проекта

src/
  index.ts                   # composition root: creates the server, wires up transport
  lib/                       # pure validation/lookup logic (no MCP dependency)
    luhn.ts
    card-networks.ts
    iban.ts
    schemas.ts
  tools/                     # one file per registered MCP tool
    validate-card-number.ts
    detect-card-type.ts
    validate-iban.ts
  resources/                 # one file per registered MCP resource
    card-networks.ts

Примечания

• Никогда не используйте console.log в этом сервере — stdout зарезервирован для потока протокола JSON-RPC через stdio. Для любого отладочного вывода используйте console.error.