mcpField
M
mcp-nubank

mcp-nubank

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-nubank

mcp-nubank 是面向 Nubank 银行服务的 MCP 服务，基于 Open Finance Brasil 标准。该项目已弃用：README 记录其调用的 api.nubank.com.br 域名无法解析，当前无可用端点，工具无法访问服务。

主要功能

  1. 01覆盖账户、余额、交易和账单查询
  2. 02提供 PIX 转账、定时转账与 PIX 密钥管理
  3. 03支持银行卡查询、冻结与解冻
  4. 04支持 OAuth2 客户端凭证与 mTLS 证书认证

适用场景

  1. 01参考 Nubank 相关 MCP 服务的工具设计
  2. 02为已配置可用端点的环境重新接入服务

MCP 相关

该项目为 MCP 服务，向 MCP 客户端暴露 22 个工具，包括账户查询、PIX 与银行卡操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-nubank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-nubank"
      ],
      "env": {
        "NUBANK_CLIENT_ID": "<NUBANK_CLIENT_ID>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-nubank
需要配置的环境变量
NUBANK_CLIENT_ID密钥API key/token for nubank

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-nubank0.2.0-alpha.4

工具

22

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

@codespar/mcp-nubank

已弃用：没有可用的服务端点。 2026-09-27 使用两个公共 DNS 解析器（8.8.8.8 和 1.1.1.1）测得：此服务端调用的主机 api.nubank.com.br 无法通过 DNS 解析。我们发现 Nubank 唯一的公共 API 是 NuPay for Business（api.spinpay.com.br），而 @codespar/mcp-nupay 已经支持该 API。此服务端中的工具均无法访问任何服务。此软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的服务端点，可通过 NUBANK_BASE_URL 将服务端指向该端点。要恢复此软件包，请在 mcp-dev-latam 中提交问题，并附上提供商文档中记载的基础 URL。

使用 Open Finance Brasil 标准的 Nubank MCP 服务。Nubank 是巴西最大的数字银行。

npm License: MIT

Alpha 版本 — 通过 npm alpha dist-tag 发布。端点路径遵循公开文档和 BACEN／提供商惯例，但尚未经过完整的线上验证。在 0.x.x-alpha 阶段，请固定使用确切版本。使用 npm install @codespar/mcp-nubank@alpha 安装。

快速开始

# Set your credentials
export NUBANK_CLIENT_ID="your-client-id"
export NUBANK_CLIENT_SECRET="your-client-secret"
export NUBANK_CERT_PATH="/path/to/certificate.pem"

# Run via stdio
npx -y @codespar/mcp-nubank@alpha

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-nubank@alpha

环境变量

变量必填说明
NUBANK_CLIENT_ID是OAuth2 客户端 ID
NUBANK_CLIENT_SECRET是OAuth2 客户端密钥
NUBANK_CERT_PATH是mTLS 证书文件的路径
MCP_HTTP否设置为 "true" 以启用 HTTP 传输
MCP_PORT否HTTP 端口（默认为 3000）

工具（22）

工具用途
get_accounts列出所有账户（支票账户、储蓄账户）
get_balance获取账户余额
get_transactions按筛选条件列出交易
get_credit_card_bill获取信用卡账单详情
get_investments列出投资项目及收益
initiate_pix发起 PIX 转账
get_pix_keys列出已登记的 PIX 密钥
get_statement获取指定期间的账户对账单
get_profile获取已认证用户的个人资料信息
list_cards列出借记卡和信用卡
get_pix_transfer获取指定 PIX 转账的状态和详情
schedule_pix预约未来日期的 PIX 转账
cancel_scheduled_pix取消先前预约的 PIX 转账
create_pix_key为已认证账户登记新的 PIX 密钥
delete_pix_key移除已登记的 PIX 密钥
get_card_details获取单张借记卡或信用卡的详情
block_card锁定卡片（报告卡片遗失／被盗或暂时停用卡片）
unblock_card解锁先前锁定的卡片（仅适用于临时锁定）
get_credit_card_transactions列出指定信用卡账单中的交易
pay_credit_card_bill使用关联账户支付信用卡账单
get_boleto根据条形码或可读数字串获取 boleto 详情
pay_boleto使用关联账户支付 boleto

身份验证

使用带有 mTLS 证书的 OAuth2 客户端凭据流程。通过 Nubank 的 Open Finance 门户注册应用以获取凭据。

API 参考

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上，添加策略引擎、付款路由和合规模板。

身份验证

启动服务端前，请设置以下环境变量：

  • NUBANK_CLIENT_ID （必填，机密） — nubank 的 API 密钥／令牌

请在提供商的开发者门户中申请凭据：https://openfinancebrasil.org.br。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。