IBANforge

IBAN 验证与 BIC/SWIFT 查询 API，提供 SEPA 合规性数据、发行方分类、风险指标、x402 微支付以及面向 AI 代理的 MCP 集成。

功能特性

• IBAN 验证 — 完整的 mod-97 校验和验证、BBAN 结构解析，支持 84 个国家/地区

• BIC/SWIFT 查询 — 来自 GLEIF 的 12.1 万多条带有 LEI 丰富信息的条目

• 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