bankmcp

BankMCP 快速入门

Your AI now reads your bank：自托管只读银行 MCP 连接器（npm 包 bankmcp，MIT，TypeScript）

这是什么？适合谁？

BankMCP™（noskillish/bankmcp）不是一个银行，而是一个你自己托管的小型开源 MCP Server（npm 包 bankmcp）。它通过 Enable Banking（一个把 2700+ 欧洲银行封装成单一 PSD2 API 的持牌聚合商）把你的银行账户接入任意 MCP 客户端（Claude Desktop、Claude Code、Cursor、Ollama 等），让 AI 助手能直接回答”Acme 的发票付了吗""八月买菜花了多少""我订了哪些订阅、一年多少钱”这类问题。

核心设计：只读、单用户、无支付。服务器不存储余额与交易流水，不发遥测；你登录的是银行自己的站点，Enable Banking 不保存数据、也看不到你的银行凭据。

数据链路：你的助手 ──OAuth──▶ BankMCP 服务器 ──JWT──▶ Enable Banking ──PSD2──▶ 你的银行。需要注意：Enable Banking 这一跳不在你的机器上（这是 PSD2 合规链路的固有部分），其余全部自托管。

适合谁：欧洲银行账户持有人（PSD2 覆盖地区），想让 Claude/Cursor 等本地 MCP 客户端查询个人财务、做订阅审计、现金流监控的个人用户或自由职业者；想要”AI 管账但钱和凭据不出本机”的隐私优先用户。

不适合：欧洲以外（美国/亚洲）银行用户（Enable Banking 目前主要覆盖欧洲 PSD2 银行）；需要支付、转账、记账写入的用户（明确只读）；企业多账户财务系统（定位单用户个人工具）。

准备工作

• 设备与软件：Node 24+（本地运行方式）；桌面 MCP 客户端（Claude Code / Claude Desktop / Cursor）或任意 stdio MCP 客户端
• 账号：一个免费的 Enable Banking 账号（注册应用、拿 application id + key 文件）
• 银行：你的银行在 Enable Banking 的 2700+ 欧洲银行覆盖列表内
• 费用：软件 MIT 开源免费；Enable Banking 注册免费（其商业条款以官网为准，本站未做付费场景实测）
• 时间预算：官方称全流程约 10 分钟
• 安全认知：银行凭据只在银行自己的站点输入；BankMCP 服务器不存余额/流水、无遥测；Enable Banking 是持牌 PSD2 中间方

3 步快速上手

第 1 步：把 bankmcp 加进你的 MCP 客户端

Claude Code：

claude mcp add bankmcp -- npx -y bankmcp

Claude Desktop：下载 bankmcp.mcpb 双击安装；或在 claude_desktop_config.json 手工添加：

{ "mcpServers": { "bankmcp": { "command": "npx", "args": ["-y", "bankmcp"] } } }

Cursor 及其他 stdio 客户端：同样 npx -y bankmcp。

第 2 步：注册 Enable Banking 应用并完成 OAuth 连接

对助手说任意银行相关问题，它会回答一个 localhost 地址。打开该地址：

1. 按页面列出的值到 Enable Banking 注册应用，把 application id 和 key 文件填回
2. 浏览器会对 localhost 的自签证书警告一次（Enable Banking 要求银行回调走 https，服务器为自己生成的证书）——确认继续；想消除警告可用 mkcert localhost 127.0.0.1 生成受信证书并通过 TLS_CERT_PATH / TLS_KEY_PATH 指定
3. 说 “connect my bank”，在银行自己的站点登录并授权

第 3 步：用自然语言查账并验证

成功判定：助手能回答真实账户问题，例如：

八月我们在超市花了多少钱？我订了哪些订阅，每年各多少钱？

状态目录 ~/.bankmcp（含 Enable Banking 密钥与银行授权），删除该目录即完全遗忘一切连接。服务器本机运行时无需密码；部署到小服务器（供 claude.ai / 手机使用）时首次需设一个登录密码。

初级用法

• 订阅审计：「列出我所有的定期扣款，按年化成本排序」——找出 forgotten subscriptions
• 发票核对：「Acme 的发票付了吗？什么时候付的？」
• 消费分析：「过去 90 天餐饮类支出趋势如何？」
• 余额提醒：「当余额低于 5000 时告诉我」
• 多行对账：「把这个 CSV 里的支出和银行流水逐笔核对，列出对不上的」

高级玩法

• 小服务器部署：Railway（Deploy from GitHub repo，挂 /data 卷 + 生成域名即可，Dockerfile/railway.json 自动识别）；或任意容器主机 docker compose up -d + Caddy 两行 TLS（YOUR-HOST { reverse_proxy localhost:8080 }），设 BASE_URL 为公网地址——之后可在 claude.ai 网页版和手机上使用
• 可信证书：mkcert 生成受信 TLS 证书替换自签，消除每次的浏览器警告（服务器不碰系统信任库）
• 与其他 MCP 工具组合：bankmcp 提供数据 + 电子表格/数据库类 MCP 做分析，搭出”本地个人 CFO”流水线
• 隐私边界验证：~/.bankmcp 目录只有你自己可读；定期检查该目录可确认没有余额/流水被持久化

常见踩坑

1. 症状：浏览器警告证书不信任。 原因：Enable Banking 的银行回调要求 https，本地服务器用了自签证书。解决：这是预期行为，确认继续即可；或用 mkcert 制作受信证书并设 TLS_CERT_PATH / TLS_KEY_PATH。
2. 症状：连接的银行列表里找不到我的银行。 原因：Enable Banking 覆盖 2700+ 欧洲 PSD2 银行，欧洲以外或小型机构可能不在列。解决：先到 Enable Banking 应用目录确认覆盖，再决定是否使用（本站未实测非欧洲银行）。
3. 症状：AI 报”无法支付/转账”。 原因：这是设计而非故障——BankMCP 只读、无支付能力。解决：把支付动作留给银行官方 App；本工具定位查询与监控。
4. 症状：Node 版本过旧启动失败。 原因：要求 Node 24+。解决：升级 Node 后重跑 npx -y bankmcp。
5. 症状：担心数据经过第三方。 原因：对链路的误解。解决：银行凭据只在银行站点输入；余额/交易每次请求经 Enable Banking 传到你本机但不被其存储；BankMCP 服务器自身不存余额流水、无遥测——这是 PSD2 持牌聚合的合规结构，但”Enable Banking 这一跳不在你机器上”是事实，介意者慎用。
6. 症状：想彻底移除。 原因：残留授权。解决：删除 ~/.bankmcp 目录即遗忘全部密钥与授权；服务器端无任何账户残留（本就不存余额）。

小技巧

• 首次问一个具体的小问题（如”当前余额”）比”分析我的财务”更快完成 OAuth 并验证链路。
• 订阅审计按年化成本排序最有杀伤力——小额月扣年化后往往吓人。
• 服务器部署模式记得设一个强密码：只有本机模式才无需密码。
• 定期（如每月）跑一次”订阅清单”对比，防止静默涨价与新增扣款。

常见问题 FAQ

Q1: 它会存储我的银行流水吗？

A: 不会。服务器只保存 Enable Banking 应用密钥、银行授权和账户 id，不存储余额与交易，也无遥测。数据链路中 Enable Banking 不存储数据、看不到你的银行凭据（你登录的是银行自己的站点）。

Q2: 支持欧洲以外的银行吗？

A: Enable Banking 聚合 2700+ 欧洲 PSD2 银行；美国/亚洲银行支持情况以其官方目录为准，本站未实测。非欧洲用户建议先确认覆盖再投入。

Q3: 免费吗？

A: BankMCP 软件本身 MIT 开源免费；需要一个免费的 Enable Banking 账号。Enable Banking 的长期商业条款（如流量限额）以其官网为准，本站未做付费场景验证。

Q4: 和直接用银行 App / 商业记账 SaaS 有什么区别？

A: 银行 App 需要人工翻查，无法用自然语言问”订阅年化成本”；商业记账 SaaS（Plaid 类聚合 + 云端分析）需要把数据交给第三方并按月付费。BankMCP 换取的是”AI 可查询 + 数据最小化”，代价是 PSD2 覆盖限制与自托管维护成本。

Q5: 能多人/团队使用吗？

A: 官方定位 single user、one user。团队共享需自行部署多实例并各自授权，不建议共享 ~/.bankmcp。

Q6: 安全审计过吗？

A: 项目极新（2026-09-07 创建），无独立安全审计报告。只读设计降低了风险面，但 PSD2 凭据链路建议自行评估（本站未实测）。

参考链接

• 官方仓库
• Enable Banking
• Claude Desktop 安装包 bankmcp.mcpb

本文基于公开资料（GitHub 官方 README）整理，AI 辅助生成，未做真实银行连接实测；采集日期 2026-09-09。功能与边界描述以官方仓库最新说明为准。