payments-toolkit-mcp

직접 실습하며 배우기 위해 만든 최소한의 Model Context Protocol (MCP) 서버입니다(전체 단계별 가이드는 PLAN.md 참조).

결제 관련 검증 유틸리티를 MCP 도구와 정적 리소스 하나로 제공합니다. 모두 로컬 로직이며 네트워크 호출이나 API 키가 필요 없습니다.

도구

• validate_card_number — 카드 번호(숫자만, 8~19자리)에 대한 Luhn 체크섬 검증입니다.

• 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

클라이언트를 연결하지 않고 로컬 웹 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를 사용하세요.