open-banking.io MCP サーバー

open-banking.io PSD2 API 向けの、薄い読み取り専用の Model Context Protocol サーバーです。AI エージェント（Claude Desktop、Cursor、任意の MCP クライアント）が、自分の銀行口座に対して*「残高はいくら？」や「先月の取引を要約して」*といった質問に答えられるようにします。

公式の open-banking-io Python SDK をラップし、そのゼロ知識特性を継承しています。サービスが返すのは暗号文のみで、機密フィールド（IBAN、名義人名、金額、取引先）はすべて、エクスポートした秘密鍵でプロセス内で復号されます。平文が第三者に触れることは一切ありません。LLM が見るのは、MCP クライアントが送信したものだけです。

ツール

すべてのツールは読み取り専用です。同期、支払い開始、同意管理のツールは意図的にありません。制限事項を参照してください。

Related MCP server: plaid-mcp

設定

アプリで認証情報をエクスポートするには、設定 → 認証情報 に移動します。

Claude Desktop

claude_desktop_config.json（Claude → 設定 → 開発者 → 設定ファイルを編集）:

{
  "mcpServers": {
    "open-banking-io": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/open-banking-io/mcp-server.git",
        "obi-mcp"
      ],
      "env": {
        "OBI_CREDENTIALS": "/absolute/path/to/credentials.json"
      }
    }
  }
}

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "open-banking-io": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/open-banking-io/mcp-server.git",
        "obi-mcp"
      ],
      "env": {
        "OBI_CREDENTIALS": "/absolute/path/to/credentials.json"
      }
    }
  }
}

uv が必要です（curl -LsSf https://astral.sh/uv/install.sh | sh）。 PyPI に公開されたら、--from git+… 引数は削除できます。

ローカル / ソースから実行

git clone https://github.com/open-banking-io/mcp-server.git
cd mcp-server
uv venv && uv pip install -e '.[dev]' --python .venv/bin/python
OBI_CREDENTIALS=/path/to/credentials.json .venv/bin/obi-mcp   # speaks MCP over stdio
.venv/bin/python tests/smoke.py                               # network-free smoke test
uv run --python .venv/bin/python pytest -q                    # full test suite

エージェントへの質問例

• 「全口座の確定残高を表示して」

• 「7月に食料品にいくら使った？」（get_transactions + グループ化）

• 「期限が近い銀行接続はどれ？」（list_connections）

設計メモ

• 構造的に読み取り専用。 SDK の get_* メソッドのみを公開しています。sync/sync_all は SDK に存在しますが、意図的に提供していません。エージェントがこのサーバーを通じて資金を移動したり、同意を変更したりすることはできません。

• 正確な金額。 金額は正確な10進文字列（"1234.56"）で返されます。浮動小数点数は使いません。

• 明確なエラー。 認証情報の欠落、不正な日付、不明な口座 ID、上流の HTTP エラーは、実行可能なツールエラーとして表面化されます（例: 見つからない場合に有効な口座 ID を一覧表示するなど）。

• コンテキストに優しい。 get_transactions はデフォルトで 50 件、最大 500 件にクランプされ、エージェントのコンテキストウィンドウを保護します。ページネーションには offset を使用します。

制限事項（正直なリスト）

• 書き込みツールはありません。同期、支払い開始、同意の作成/更新はありません。同意の更新は常に open-banking.io アプリ（PSD2 SCA）で行われます。

• 銀行/金融機関ディレクトリツールはありません。上流 API（SDK v1.0.0）は公開 ASPSP 検索エンドポイントを公開していません。API に追加されたら TODO。

• まだ PyPI に公開されていません。uvx --from git+…（上記）またはソースからインストールしてください。open-banking-io-mcp として PyPI に公開する予定です。

• データ最小化はお客様の責任です。取引には取引先と送金情報が含まれます。このサーバーは信頼できる MCP クライアントにのみ接続し、プライバシーを考慮して、ホスト型 MCP クライアントよりもローカル MCP クライアント（Claude Desktop / Cursor）を優先してください。

ラップされる API サーフェス

認証: X-Api-Key ヘッダー。レスポンスはゼロ知識エンベロープ（ECDH P-256 → HKDF-SHA256 → AES-256-GCM）を保持し、SDK がローカルで復号します。 完全なワイヤーフォーマット: clients リポジトリ ・ THREAT_MODEL.md。

ライセンス

MIT — clients SDK リポジトリと同じです。