payments-toolkit-mcp

最小限のModel Context Protocol（MCP）サーバーで、実践的な学習プロジェクトとして構築されています（詳細なステップバイステップのチュートリアルはPLAN.mdを参照）。

決済関連の検証ユーティリティをMCPツールと1つの静的リソースとして公開します。すべてローカルロジックで、ネットワーク呼び出しもAPIキーも不要です。

ツール

• validate_card_number — カード番号のLuhnチェックサム検証（数字のみ、8〜19桁）。

• detect_card_type — IIN/BINプレフィックスからカードネットワーク（Visa、Mastercard、American Express、Discover、Diners Club、JCB）を識別します。

• validate_iban — IBANの形式、国別の長さ、ISO 13616 mod-97チェックサム検証。

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

クライアントを接続せずに、ローカルWeb UIからツール/リソースを直接確認・呼び出します：

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はstdio上のJSON-RPCプロトコルストリーム用に予約されています。デバッグ出力にはconsole.errorを使用してください。