mcpField
M
mcp-open-finance

mcp-open-finance

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

关于 mcp-open-finance

mcp-open-finance 是 Open Finance Brasil 的 MCP 服务，面向需要读取巴西银行账户数据或发起 PIX 支付的应用与开发者。它覆盖账户、交易、同意管理、信用卡、贷款、投资等数据，并支持支付发起。

主要功能

  1. 01账户余额、交易与透支额度查询
  2. 02信用卡账单与交易查询
  3. 03贷款、融资与投资产品列表
  4. 04数据共享与支付同意的创建和撤销
  5. 05PIX 等支付发起与客户资质查询

适用场景

  1. 01在 AI 助手中查看客户银行账户与交易记录
  2. 02管理数据共享同意的创建与撤销
  3. 03通过已授权的同意发起 PIX 支付

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 18 个工具，用于通过金融机构的 Open Finance API 读取数据并管理同意与支付。

配置

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

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

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

安装包
npm@codespar/mcp-open-finance0.2.2

工具

18

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

参数类型必填说明
pagenumber否页码
pageSizenumber否每页项目数
consentIdstring是同意 ID（数据访问必填）

详细介绍

@codespar/mcp-open-finance

面向 Open Finance Brasil 的 MCP 服务——用于账户、交易和授权的开放银行标准

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "open-finance": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-open-finance"],
      "env": {
        "OPEN_FINANCE_BASE_URL": "https://api.institution.com.br",
        "OPEN_FINANCE_CLIENT_ID": "your-client-id",
        "OPEN_FINANCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}
Claude Code
claude mcp add open-finance -- npx @codespar/mcp-open-finance
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "open-finance": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-open-finance"],
      "env": {
        "OPEN_FINANCE_BASE_URL": "https://api.institution.com.br",
        "OPEN_FINANCE_CLIENT_ID": "your-client-id",
        "OPEN_FINANCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

工具（18 个）

工具用途
list_accounts通过 Open Finance 列出客户银行账户
get_account_balance通过 Open Finance 获取账户余额
list_transactions通过 Open Finance 列出账户交易
get_account_overdraft_limits通过 Open Finance 获取账户透支限额（limites）
get_consent按 ID 获取授权详情
create_consent创建新的数据访问授权请求
revoke_consent撤销现有授权（数据或支付）
list_credit_cards通过 Open Finance 列出信用卡账户
get_credit_card_bills通过 Open Finance 获取信用卡账单（faturas）
get_credit_card_transactions通过 Open Finance 获取信用卡交易
list_loans通过 Open Finance 列出贷款合同（empréstimos）
get_loan_payments通过 Open Finance 获取贷款还款计划
list_financings通过 Open Finance 列出融资合同（financiamentos）
list_investments通过 Open Finance 列出投资产品
create_payment_consent通过 Open Finance 创建支付发起授权（例如 PIX）
create_payment使用已授权的支付授权发起支付
get_personal_qualifications通过 Open Finance 获取个人客户资质信息（收入、职业）
get_business_qualifications通过 Open Finance 获取企业客户资质信息

身份验证

Open Finance Brasil 使用 OAuth2 客户端凭证。每家金融机构都有自己的基础 URL 和凭证。

沙盒 / 测试

各机构的沙盒可用情况不尽相同。请联系你的金融机构，申请使用 Open Finance 沙盒。

获取凭证
  1. 前往 Open Finance Brasil
  2. 在参与的金融机构注册
  3. 获取 OAuth2 客户端凭证
  4. 设置环境变量

环境变量

变量必需说明
OPEN_FINANCE_BASE_URL是机构 API 基础 URL
OPEN_FINANCE_CLIENT_ID是OAuth2 客户端 ID
OPEN_FINANCE_CLIENT_SECRET是OAuth2 客户端密钥

路线图

v0.2（计划中）
  • revoke_consent — 撤销数据共享授权
  • list_payments — 列出已发起的支付
  • create_payment_consent — 创建支付发起授权
  • initiate_payment — 通过 Open Finance 发起支付
  • get_payment_status — 获取支付发起状态
v0.3（计划中）
  • insurance_products — 列出机构提供的保险产品
  • pension_products — 列出机构提供的养老金产品

想要贡献？提交 PR 或申请工具。

链接

企业版

需要为 Agent 支付添加治理、预算限额和审计追踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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