IBANforge

SEPA 규정 준수 데이터, 발행 기관 분류, 위험 지표, x402 마이크로페이먼트 및 AI 에이전트를 위한 MCP 통합 기능을 갖춘 IBAN 검증 및 BIC/SWIFT 조회 API입니다.

주요 기능

• IBAN 검증 — 전체 mod-97 체크섬 확인, BBAN 구조 파싱, 84개국 지원

• BIC/SWIFT 조회 — LEI 정보가 보강된 GLEIF의 121,000개 이상의 데이터

• SEPA 규정 준수 — 회원 상태, 결제 방식(SCT/SDD/SCT_INST), 국가별 VoP 요구 사항

• 발행 기관 분류 — 전통적인 은행, 네오뱅크, EMI(Wise, Revolut, N26 등) 및 vIBAN 감지를 위한 결제 기관 식별

• 위험 지표 — 복합 위험 신호: 발행 기관 유형, 국가 위험도(FATF 기반), 테스트용 BIC, SEPA 도달 가능성, VoP 커버리지

• 일괄 처리 — 한 번의 호출로 최대 100개의 IBAN 검증

• x402 마이크로페이먼트 — USDC를 사용한 호출당 결제 (요청당 $0.002부터)

• MCP 서버 — Model Context Protocol을 통한 네이티브 AI 에이전트 통합

• 자체 호스팅 — Docker 배포, SQLite 데이터베이스, 외부 의존성 없음

빠른 시작

git clone https://github.com/cammac-creator/ibanforge.git
cd ibanforge
npm install
cp .env.example .env
npm run dev

API 엔드포인트

예시

IBAN 검증

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

BIC 조회

curl https://api.ibanforge.com/v1/bic/UBSWCHZH80A

MCP 통합

Claude Desktop 또는 AI 에이전트 설정에 추가하세요:

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "cwd": "/path/to/ibanforge"
    }
  }
}

사용 가능한 도구: validate_iban, batch_validate_iban, lookup_bic

개발

npm run dev          # Dev server (hot reload)
npm run test         # Run tests
npm run check        # Typecheck + lint + test
npm run db:seed      # Rebuild BIC database from GLEIF

배포

Docker

docker build -t ibanforge .
docker run -p 3000:3000 --env-file .env ibanforge

Railway

main 브랜치에 푸시하면 Railway가 Dockerfile을 통해 자동으로 배포합니다.

환경 변수

데이터 소스

• BIC/SWIFT 항목: GLEIF BIC-LEI 매핑

• LEI 보강: GLEIF API

• 국가명: Node.js Intl.DisplayNames API

라이선스

MIT