IBAN Checker MCP

ibanchecker-mcp

面向 ibanchecker.cash 的 MCP（Model Context Protocol）服务。为 Claude 等 AI 助手提供五种由 ibanchecker.cash 验证引擎支持的金融工具：

工具	功能
validate_iban	验证单个 IBAN：国家、长度、国家 BBAN 结构、MOD-97 校验位，以及可用时的银行详情
validate_bulk_ibans	一次调用验证最多 100 个 IBAN
extract_ibans_from_text	在一段文本（电子邮件、发票、电子表格）中查找并验证所有 IBAN
get_iban_format	查询 92 个支持国家中任意一个国家的 IBAN 格式规范
lookup_bic	通过 BIC/SWIFT 代码查询银行

IBAN 数据不会被记录或存储；验证在 Cloudflare 边缘节点的内存中运行。详情请参阅安全页面。

快速开始：托管远程服务

最简单的方式是使用托管端点。无需安装或部署。除 get_iban_format 外，每种工具都需要 API 密钥（参见 API 密钥）。

https://mcp.ibanchecker.cash/mcp

Claude Code

claude mcp add --transport http ibanchecker https://mcp.ibanchecker.cash/mcp --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop（claude_desktop_config.json），通过 mcp-remote 桥接：

{
  "mcpServers": {
    "ibanchecker": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.ibanchecker.cash/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": {
        "AUTH_HEADER": "Bearer your-api-key-here"
      }
    }
  }
}

本地 stdio 服务

通过 stdio 在本地运行服务（需要 Node 18+）：

{
  "mcpServers": {
    "ibanchecker": {
      "command": "npx",
      "args": ["-y", "@ibanchecker/mcp"],
      "env": {
        "IBANCHECKER_API_KEY": "your-api-key-here"
      }
    }
  }
}

示例

使用 DE89370400440532013000 调用 validate_iban 会返回：

{
  "valid": true,
  "iban": "DE89370400440532013000",
  "formatted": "DE89 3704 0044 0532 0130 00",
  "country_name": "Germany",
  "bank_name": "Commerzbank AG Cologne",
  "bic": "COBADEFFXXX",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "sepa": true
}

当 API 返回错误时（例如 429 请求频率受限、401 缺少密钥或密钥无效，或 403 工具不在密钥对应的套餐范围内），工具结果会标记为 isError: true，并附带人类可读的消息，以便助手作出相应处理，而不是崩溃。

API 密钥

除 get_iban_format 外，每种工具都需要 API 密钥，密钥可调用的工具取决于其套餐：

工具	免费密钥	已验证账户的免费密钥	Basic / Starter	Growth / Enterprise
validate_iban	是	是	是	是
validate_bulk_ibans	否	每次调用最多 10 个 IBAN	最多 100 个	最多 100 个
lookup_bic	否	是	是	是
extract_ibans_from_text	否	每次调用最多 5,000 个字符	已验证账户可试用	最多 50,000 个
get_iban_format	是	是	是	是

get_iban_format 也可在不使用密钥的情况下调用，每个 IP 每小时最多 100 次请求。免费密钥每月可处理 100 次请求，几秒内即可通过电子邮件收到：前往 ibanchecker.cash/api-docs 获取。使用相同邮箱地址在 ibanchecker.cash/dashboard 创建免费账户，即可开通试用。批量验证和提取按每个 IBAN 计为一次请求。更高用量请参阅 ibanchecker.cash/pricing。密钥可通过以下方式传递：

• IBANCHECKER_API_KEY 环境变量（stdio 模式），或
• Authorization: Bearer <key> / x-api-key 标头（远程模式）。

项目结构

.
├── bin/stdio.mjs      # npm CLI entry (published as `ibanchecker-mcp`)
├── shared/tools.mjs   # the 5 tool definitions, shared by both transports
└── worker/            # Cloudflare Worker (the hosted remote server)
    ├── src/index.ts
    └── wrangler.toml

stdio CLI 和 Worker 注册的工具完全相同，均来自 shared/tools.mjs，因此只有一个事实来源。

自托管 Worker

远程服务是基于 Agents SDK 构建的 Cloudflare Worker。部署你自己的服务：

cd worker
npm install
npx wrangler deploy

移除 worker/wrangler.toml 中的 routes 区块（或将其指向你自己的域名），并可选择使用 npx wrangler secret put IBANCHECKER_API_KEY 设置全服务密钥。

许可证

MIT。参见 LICENSE。