open-banking.io MCP-сервер

Тонкий только для чтения сервер Model Context Protocol для PSD2 API сервиса open-banking.io. Он позволяет ИИ-агентам (Claude Desktop, Cursor, любому MCP-клиенту) отвечать на вопросы вроде «Какой у меня баланс?» и «Дай сводку транзакций за прошлый месяц» по вашим собственным банковским счетам.

Он оборачивает официальный Python SDK open-banking-io и наследует его свойство zero-knowledge: сервис всегда возвращает только шифротекст, а каждое чувствительное поле (IBAN, имя владельца, суммы, контрагенты) расшифровывается в процессе работы с помощью вашего выгруженного закрытого ключа. Никакие открытые данные никогда не касаются третьей стороны — в том числе LLM видит только то, что ваш MCP-клиент отправляет ей.

Инструменты

Все инструменты — только для чтения. Намеренно отсутствуют инструменты синхронизации, инициации платежей или управления разрешениями — см. Ограничения.

Related MCP server: plaid-mcp

Конфигурация

Экспортируйте учётные данные в приложении → Settings → Credentials, чтобы получить файл с комплектом.

Claude Desktop

claude_desktop_config.json (Claude → Settings → Developer → Edit Config):

{
  "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

Примеры вопросов для вашего агента

• «Покажи проведённый остаток по каждому счёту.»

• «Сколько я потратил на продукты в июле?» (get_transactions + группировка)

• «Какие банковские подключения скоро истекают?» (list_connections)

Заметки по проектированию

• Только для чтения по построению. Доступны только методы get_* из SDK. sync/sync_all в SDK есть, но намеренно не предлагаются; агенты не могут переводить деньги или изменять разрешения через этот сервер.

• Точные деньги. Суммы возвращаются как точные десятичные строки ("1234.56"), никогда не как числа с плавающей точкой.

• Понятные ошибки. Отсутствующие учётные данные, неверные даты, неизвестные идентификаторы счетов и ошибки вышестоящего HTTP-сервиса превращаются в понятные ошибки инструментов (например, при промахе выводится список допустимых идентификаторов счетов; неверной дате).

• Бережёт контекст. get_transactions по умолчанию берёт 50 записей и ограничивает их до 500, чтобы не перегружать контекстное окно агента; используйте offset для постраничной навигации.

Ограничения (честный список)

• Нет sync из SDK (нет инструментов записи, инициации платежей, создания/обновления разрешений). Обновление разрешений всегда происходит в приложении open-banking.io (PSD2 SCA).

• Нет инструмента каталога банков/организаций: API, которое используется (в clients SDK v1.0.0) не предоставляет публичного эндпоинта поиска ASPSP — TODO, если/когда такой появится.

• Пакет пока не опубликован на PyPI — устанавливайте через uvx --from git+… (см. выше) или из исходников. Публикация на PyPI как open-banking-io-mcp планируется.

• Минимизация данных — ваша ответственность: транзакции включают контрагентов и текст платежа; подключайте этот сервер только к доверенным MCP-клиентам и предпочитайте локальные MCP-клиенты (Claude Desktop / Cursor) облачным из соображений приватности.

Обёрнутая часть API

Авторизация: заголовок X-Api-Key. Ответы содержат zero-knowledge конверты (ECDH P-256 → HKDF-SHA256 → AES-256-GCM), расшифровываемые локально SDK. Полный формат передачи данных: clients repo · THREAT_MODEL.md.

Лицензия

MIT — так же, как и у репозиториев SDK clients.