IBAN Checker MCP

ibanchecker-mcp

ibanchecker.cash 用の MCP（Model Context Protocol）サーバーです。ibanchecker.cash の検証エンジンを利用した 5 つの金融ツールを、Claude などの AI アシスタントに提供します。

ツール	機能
validate_iban	単一の IBAN を検証します。国、長さ、国内 BBAN 構造、MOD-97 チェックディジット、および利用可能な場合は銀行情報を確認します
validate_bulk_ibans	1 回の呼び出しで最大 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 キーが必要です。キーで呼び出せるツールは、そのプランによって異なります。

ツール	Free キー	アカウント認証済みの Free キー	Basic / Starter	Growth / Enterprise
validate_iban	はい	はい	はい	はい
validate_bulk_ibans	いいえ	1 回につき最大 10 件の IBAN	最大 100 件	最大 100 件
lookup_bic	いいえ	はい	はい	はい
extract_ibans_from_text	いいえ	1 回につき最大 5,000 文字	アカウント認証済みの場合はトライアル	最大 50,000 文字
get_iban_format	はい	はい	はい	はい

get_iban_format はキーなしでも利用できます。IP ごとに 1 時間あたり最大 100 リクエストです。Free キーでは月 100 リクエストが利用でき、数秒でメールに届きます。ibanchecker.cash/api-docsで取得してください。同じメールアドレスでibanchecker.cash/dashboardに無料アカウントを作成すると、トライアルを利用できます。一括検証と抽出では、IBAN 1 件につき 1 リクエストとしてカウントされます。より多くのリクエストについては、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 にあるまったく同じツールを登録するため、信頼できる情報源は 1 つです。

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をご覧ください。