open-banking.io MCP server

一个轻量、只读的 Model Context Protocol 服务器，用于 open-banking.io PSD2 API。它让 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

给代理的示例问题

• “显示每个账户的已记账余额。”

• “我七月份在食品杂货上花了多少钱？”（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+…（见上文）或从源码安装。计划以 open-banking-io-mcp 发布到 PyPI。

• 数据最小化是你的责任：交易包含交易对手和汇款文本；只将此服务器指向你信任的 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 仓库相同。