mcp-inter-bank

Name: mcp-inter-bank
Author: codespar

本地服务

github.com/codespar金融数据2755 周前更新

代码仓库

关于 mcp-inter-bank

@codespar/mcp-inter-bank 是 Banco Inter 的 MCP 服务，Banco Inter 是巴西数字银行。它面向需要处理 boleto、Pix、转账与账户对账的应用，通过 OAuth2 客户端凭证访问银行 API。

主要功能

01创建、查询与撤销 boleto
02Pix 即时收款（cob、cobv）与退款
03查询余额、对账单与 PDF 对账单
04创建 TED 或内部转账
05注册 boleto 与 Pix 的 webhook

适用场景

01为客户生成 boleto 与 Pix 收款码
02查询账户余额并导出对账单
03配置 webhook 接收 Pix 与 boleto 状态通知

MCP 相关

该项目以 MCP 服务形式运行，向 MCP 客户端暴露 22 个银行相关工具，覆盖收款、转账、对账单与 webhook。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-inter-bank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-inter-bank"
      ],
      "env": {
        "INTER_CLIENT_ID": "<INTER_CLIENT_ID>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-inter-bank

需要配置的环境变量

INTER_CLIENT_ID密钥API key/token for inter-bank

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

安装包

npm@codespar/mcp-inter-bank0.2.2stdio

工具

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

参数	类型	必填	说明
amount	number	是	以 BRL 计价的 Boleto 金额
due_date	string	是	截止日期（YYYY-MM-DD）
payer_zip	string	否	付款人邮政编码（CEP）
payer_city	string	否	付款人所在城市
payer_name	string	是	付款人全名
description	string	否	Boleto 描述
payer_state	string	否	付款人所在州（UF）
payer_address	string	否	付款人街道地址
payer_cpf_cnpj	string	是	付款人的 CPF 或 CNPJ

详细介绍

@codespar/mcp-inter-bank

Banco Inter 的 MCP 服务。Banco Inter 是一家巴西数字银行，提供涵盖 boletos、PIX、转账和银行业务的完整开发者 API

快速开始

# Set your credentials
export INTER_CLIENT_ID="your-client-id"
export INTER_CLIENT_SECRET="your-client-secret"

# Run via stdio
npx -y @codespar/mcp-inter-bank

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

环境变量

变量	必填	描述
`INTER_CLIENT_ID`	是	OAuth2 客户端 ID
`INTER_CLIENT_SECRET`	是	OAuth2 客户端密钥
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（22）

工具	用途
`create_boleto`	创建 boleto bancario（银行付款凭证）
`get_boleto`	根据 ID 获取 boleto 详情
`list_boletos`	按筛选条件列出 boletos
`cancel_boleto`	取消（核销）boleto
`get_boleto_pdf`	下载 boleto PDF（返回 base64 负载）
`create_pix`	创建 PIX 付款
`get_pix`	根据 ID 获取 PIX 交易详情
`list_pix`	列出 PIX 交易
`create_pix_cob`	创建带 txid 的 PIX 即时收款（cob）——返回 BR Code/复制粘贴码
`get_pix_cob`	根据 txid 获取 PIX 即时收款
`list_pix_cob`	列出指定时间范围内的 PIX 即时收款（可选按 end_to_end_id 筛选）
`create_pix_cobv`	创建带 dueDate 的 PIX 到期收款（cobv）——类似 boleto 的 PIX，带有到期日
`get_pix_cobv`	根据 txid 获取 PIX 到期收款（cobv）
`create_pix_devolucao`	为已收款交易创建 PIX 退款（devolução）
`list_pix_keys`	列出已注册到 Inter 账户的 PIX 密钥（chaves）
`get_balance`	获取账户余额
`get_statement`	获取指定日期范围的账户流水
`get_statement_enriched`	获取包含详细交易信息（交易对手、类别、Pix 详情）的增强版账户流水
`get_statement_pdf`	下载指定日期范围的账户流水 PDF（base64 负载）
`create_transfer`	创建 TED 或内部转账
`get_webhook`	获取已配置的 Webhook
`create_webhook`	注册用于接收通知的 Webhook

身份验证

使用 OAuth2 客户端凭据流程。令牌端点为 /oauth/v2/token，各 API 具有相应的权限范围：

Boletos：boleto-cobranca.read、boleto-cobranca.write
PIX：pix.read、pix.write
银行业务：extrato.read、pagamento-ted.write
Webhook：webhook-boleto.read、webhook-boleto.write、webhook-pix.read、webhook-pix.write