payments-toolkit-mcp

Ein minimaler Model Context Protocol (MCP)-Server, der als praktisches Lernprojekt entwickelt wurde (siehe PLAN.md für die vollständige Schritt-für-Schritt-Anleitung).

Er stellt zahlungsbezogene Validierungsfunktionen als MCP-Tools und eine statische Ressource bereit — alles lokale Logik, keine Netzwerkaufrufe, keine API-Schlüssel erforderlich.

Tools

• validate_card_number — Luhn-Prüfsummenvalidierung für eine Kartennummer (nur Ziffern, 8-19 Stellen).

• detect_card_type — identifiziert das Kartennetzwerk (Visa, Mastercard, American Express, Discover, Diners Club, JCB) anhand des IIN/BIN-Präfixes.

• validate_iban — Format-, länderspezifische Längen- und ISO-13616-Mod-97-Prüfsummenvalidierung für eine IBAN.

Related MCP server: stripe-mcp-server

Ressourcen

• card_networks (payments-toolkit://card-networks) — statische JSON-Auflistung der unterstützten Kartennetzwerke und ihrer Präfixbereiche.

Voraussetzungen

• Node.js 18+ (Projekt entwickelt mit v24)

• pnpm

Einrichtung

pnpm install
pnpm run build

Verwendung

Server eigenständig ausführen (er wartet auf stdio, dient also hauptsächlich zur Überprüfung):

pnpm run start

Tools/Ressource direkt über eine lokale Weboberfläche prüfen und aufrufen, ohne einen Client einzurichten:

pnpm run inspect

Mit Claude Code verbinden

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

Führen Sie in einer Claude-Code-Sitzung /mcp aus, um die Verbindung zu bestätigen und die erkannten Tools/Ressourcen zu sehen.

Projektstruktur

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

Hinweise

• Verwenden Sie in diesem Server niemals console.log — stdout ist für den JSON-RPC-Protokollstream über stdio reserviert. Verwenden Sie console.error für jegliche Debug-Ausgabe.