interbanking

interbanking-mcp

独立的非官方项目。 与 Interbanking S.A. 没有任何关联，也未获该公司认可。“Interbanking” 是其所有者的注册商标，此处仅用于说明本项目适配的 API。

可通过 Agent 查询你的 Interbanking（阿根廷）账户： 余额、历史余额和交易记录，全程使用西班牙语，无需编写代码。

仅支持只读。 没有任何工具可以转出资金，这不仅是一项约定，更是设计决策：客户端的通用功能——即接受任意 HTTP 方法的功能——被有意排除在服务之外。

安装

无需安装任何内容：启动时会自动下载。

Claude Code

claude mcp add interbanking \
  --env IB_CLIENT_ID=tu_client_id \
  --env IB_CLIENT_SECRET=tu_client_secret \
  --env IB_REDIRECT_URL=https://localhost \
  --env IB_CUSTOMER_ID=tu_customer_id \
  -- npx -y interbanking-mcp

Claude Desktop 或其他使用配置文件的客户端

{
  "mcpServers": {
    "interbanking": {
      "command": "npx",
      "args": ["-y", "interbanking-mcp"],
      "env": {
        "IB_CLIENT_ID": "tu_client_id",
        "IB_CLIENT_SECRET": "tu_client_secret",
        "IB_REDIRECT_URL": "https://localhost",
        "IB_CUSTOMER_ID": "tu_customer_id"
      }
    }
  }
}

凭据从 Interbanking 开发者门户 获取。如何获取凭据的分步说明见 interbanking-api-ejemplo。

注意凭据的存放位置。 配置文件是磁盘上的纯文本文件。 将凭据粘贴到那里之前，请阅读令牌管理 。

工具

工具	功能
listar_cuentas	可用账户，包括银行、类型、币种和账号
saldos	当前余额：账面余额和可用余额。可选范围最长 64 天
saldos_historicos	长时间范围内的每日余额；自动拆分范围
movimientos	所有账户的交易记录，包括贷方和借方总额

配置完成后，可用西班牙语与它交谈：

• “我每个账户里有多少钱？”
• “给我看看 9 月份的交易记录。”
• “从 1 月开始，Galicia 的余额是如何变化的？”
• “上周有哪些转账入账？”

关于数据量

movimientos 和 saldos_historicos 默认返回摘要：每个账户的总额，以及最近的 25 笔交易。一年的范围可能包含数千条记录，全部输出会占满 Agent 的上下文窗口，却没有任何好处。要查看全部内容，可以要求“详细显示”，最好选择较短的时间范围。

底层实现

使用 interbanking-client，用于处理门户的特殊之处：令牌参数需放在查询字符串而不是请求正文中，service 标头必须包含 https://，customer-id 作为查询参数传递，而交易记录使用的基础 URL 与余额不同。相关内容均记录在 interbanking-api-ejemplo 中。

开发

npm install
npm run check
npm test

手动测试：

npx @modelcontextprotocol/inspector node server.js

隐私

程序在你的电脑上运行，使用你的凭据，并且只与该机构通信。它不会收集任何内容，也不会向任何地方发送任何内容。详情见 PRIVACY.md。

支持

本项目按现状发布。问题请通过仓库的 issues 提交，不保证回复时限：我会在方便时回复。不提供电子邮件或电话支持。

第三方 API 可能会在未提前通知的情况下变更，导致项目无法正常运行。这不构成专业建议，使用者须自行承担使用责任。

如果对你有帮助

⭐ 欢迎在仓库中点亮一颗星，或请我喝杯咖啡。

（也可以给我写信聊聊，同样欢迎。）

许可证

MIT