Fio Bank MCP

FIO Bank MCP サーバー

チェコ共和国の FIO Bank API 用 MCP（Model Context Protocol）サーバーです。Claude などの AI アシスタントが FIO Bank の口座取引にアクセスできるようにします。

インストール

pnpm install
pnpm build

設定

API トークンの取得

1. FIO Bank のインターネットバンキングにログインします
2. Settings → API に移動します
3. 新しいトークンを作成します（SMS またはプッシュ通知が必要です）
4. トークンを使用する前に 5 分間待ちます

トークンのプロパティ

• 各トークンは 1 つの口座でのみ有効です
• 有効期間の上限：180 日
• インターネットバンキングへのログインごとに自動更新できます

使用方法

Claude Desktop での使用

Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "fio-bank": {
      "command": "node",
      "args": ["/path/to/fio-bank-mcp/dist/index.js"],
      "env": {
        "FIO_API_TOKEN": "your-64-character-token-here"
      }
    }
  }
}

利用可能なツール

fio_get_transactions

指定した期間の口座取引を取得します。

パラメーター：

名前	型	必須	説明
dateFrom	string	はい	開始日（YYYY-MM-DD）
dateTo	string	はい	終了日（YYYY-MM-DD）
token	string	いいえ	API トークン（指定がない場合は FIO_API_TOKEN 環境変数を使用します）

戻り値：

• 口座情報（IBAN、BIC、残高）
• 以下の情報を含む取引一覧：
  • 取引 ID、日付、金額、通貨
  • 相手口座（番号、名前、銀行）
  • 支払記号（可変、固定、固有）
  • 受取人向けメッセージ、コメント
  • 取引の種類

ローカルでのテスト

MCP Inspector を使用して、Web UI でサーバーをテストできます。

npx @modelcontextprotocol/inspector node dist/index.js

ブラウザーが開き、利用可能なツールの確認や、パラメーターを指定した呼び出し、レスポンスの表示ができます。

API トークンを渡すには：

FIO_API_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/index.js

API レート制限

トークンごとに 30 秒あたり 1 リクエストです。 必要に応じて、サーバーが自動的に待機します。

データへのアクセス

• 90 日以内のデータ：すぐにアクセスできます
• 90 日より古いデータ：インターネットバンキングで一時的なロック解除が必要です（Settings → API → ロックアイコンをクリック。有効時間は 10 分です）

エラーコード

コード	説明
404	無効な URL またはトークン
409	レート制限超過（30 秒待ってください）
413	レスポンス内の取引が多すぎます
422	無効なリクエストデータ
500	内部サーバーエラー

開発

pnpm install      # Install dependencies
pnpm build        # Build TypeScript
pnpm lint         # Run ESLint
pnpm typecheck    # Type check without emitting

リソース

• FIO Bank API ドキュメント（チェコ語）
• MCP プロトコル

ライセンス

MIT