open-banking.io MCP 서버

open-banking.io PSD2 API를 위한 가볍고 읽기 전용인 Model Context Protocol 서버입니다. AI 에이전트(Claude Desktop, Cursor, 모든 MCP 클라이언트)가 사용자의 은행 계좌에 대해 "내 잔액은 얼마인가요?" 또는 "지난달 거래 내역을 요약해 주세요" 같은 질문에 답할 수 있게 해줍니다.

공식 open-banking-io Python SDK를 감싸며, 제로 지식 속성을 그대로 이어받습니다. 서비스는 암호문만 반환하며, 모든 민감 필드(IBAN, 예금주 이름, 금액, 거래 상대방)는 사용자가 내보낸 개인 키로 프로세스 내에서 복호화됩니다. 평문이 제3자에게 닿는 일은 없습니다. 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에 존재하지만 의도적으로 제공하지 않으므로, 에이전트가 이 서버를 통해 자금을 이동하거나 동의를 변경할 수 없습니다.

• 정확한 금액. 금액은 부동소수점이 아닌 정확한 문자열("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+…(위 참조) 또는 소스에서 설치. PyPI에 open-banking-io-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 저장소와 동일합니다.