mcpField
M
mcp-c6

mcp-c6

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

关于 mcp-c6

mcp-c6 是面向 C6 Bank 的 MCP 服务,原计划提供 Pix、Boleto 与账户数据相关工具。该包已弃用,测得的 baas.c6bank.com.br 等域名无法解析,当前没有工具能够访问服务。它仅保留在仓库中供参考,若要恢复需提供可用的端点地址。

主要功能

  1. 01Pix 即时与到期收款相关工具(cob、cobv)
  2. 02DICT 密钥的查询、登记与删除
  3. 03Boleto 开具、查询与撤销
  4. 04账户余额与对账单查询

适用场景

  1. 01参考 C6 Bank 接口结构以开发新的 MCP 服务
  2. 02在提供可用端点后作为 Pix 与 Boleto 集成的起点

MCP 相关

该项目是 MCP 服务,原本向 MCP 客户端暴露 14 个工具,但当前没有工具能够连接到服务。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"codespar-mcp-c6": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-c6"
],
"env": {
"C6_CLIENT_ID": "<C6_CLIENT_ID>",
"C6_CLIENT_SECRET": "<C6_CLIENT_SECRET>",
"C6_CERT_PATH": "<C6_CERT_PATH>",
"C6_KEY_PATH": "<C6_KEY_PATH>",
"C6_ENV": "<C6_ENV>"
}
}
}
}
启动命令npx -y @codespar/mcp-c6
需要配置的环境变量
C6_CLIENT_IDC6 OAuth client_id issued via the Developer Portal after contract onboarding.
C6_CLIENT_SECRET密钥C6 OAuth client_secret.
C6_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2.
C6_KEY_PATH密钥Absolute path to the mTLS private key (.key or .pem).
C6_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

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

安装包
npm@codespar/mcp-c60.1.0-alpha.4

工具

14

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

此工具无需参数。

详细介绍

@codespar/mcp-c6

已弃用:没有可用的端点。 2026-09-27 使用两个公共 DNS 解析器(8.8.8.8 和 1.1.1.1)进行测量:baas.c6bank.com.br(生产环境)和 baas-sandbox.c6bank.com.br(沙盒环境)均无法通过 DNS 解析。C6 的开发者门户现在记录了 baas-api.c6bank.info(生产环境)和 baas-api-sandbox.c6bank.info(沙盒环境),两者都需要 mTLS;此服务的路径和身份验证并非针对它们编写,也未经检查。此服务中的工具均无法连接到服务。该软件包已在 npm 上弃用,仅保留在此代码库中供参考。如果你有可用的端点,可通过 C6_BASE_URL 将服务指向该端点。若要恢复此软件包,请在 mcp-dev-latam 中提交 issue,并附上提供方文档记录的基础 URL。

面向 C6 Bank 的 MCP 服务——巴西顶尖数字银行之一,获得 JPMorgan 支持。

按零售账户数量计算,C6 位列巴西最大的数字银行之列,并已积极拓展中小企业和企业银行业务。商户可直接集成 Pix、boleto 和账户数据工作流。

状态:alpha(0.1.0-alpha.1)

C6 的开发者门户受合同限制——Pix、Cobrança 和账户 API 的完整 OpenAPI 规范仅对已完成接入的商户开放。此服务中的端点路径是根据 (a) BACEN Pix v2 标准、(b) C6 的公开营销页面,以及 (c) Itaú / Santander / Bradesco 通用约定做出的最佳猜测。每个未经验证的路径都在源代码中标记为 TODO(verify)。

在 0.1.x 期间请固定到精确版本;待已完成接入的商户验证后,将根据门户规范修正路径。

工具(14 个)

工具用途
get_oauth_token为 C6 开发者门户创建或返回缓存的 OAuth2 client_credentials bearer 令牌。
create_pix_cob创建即时 Pix 收款(cob),并生成二维码。
get_pix_cob根据 txid 获取即时 Pix 收款(cob)。
list_pix_cob列出商户在指定日期范围内登记的即时 Pix 收款(cob)。
create_pix_cobv创建带到期日的 Pix 收款(cobv)——用于类似 boleto 的 Pix,付款人可在到期日或之后支付……
get_pix_cobv根据 txid 获取带到期日的 Pix 收款(cobv)。
resolve_dict_key将 DICT 密钥(CPF、CNPJ、email、phone、EVP)解析为所有者账户数据,以便发送 Pix。
register_pix_key在商户所有的 C6 账户上登记 DICT 密钥(CPF、CNPJ、email、phone 或 EVP)。
delete_pix_key删除商户所有的 DICT 密钥。
create_boleto通过 C6 Cobrança 签发 boleto。
get_boleto根据 C6 标识符(id 或 nosso_numero)获取 boleto。
cancel_boleto在付款前取消(baixa)未结清的 boleto。
get_account_balance获取商户账户的当前余额快照。
get_statement获取指定期间的账户流水交易记录。

安装

npm install @codespar/[email protected]

环境变量

C6_CLIENT_ID="..."        # OAuth client_id from C6's Developer Portal
C6_CLIENT_SECRET="..."    # OAuth client_secret
C6_CERT_PATH="/abs/path/to/client.crt"   # mTLS client certificate
C6_KEY_PATH="/abs/path/to/client.key"    # mTLS private key
C6_ENV="sandbox"                          # or "production" (default: sandbox)

身份验证

每次调用都必须同时满足以下两个条件:

  1. OAuth2 client_credentials——服务调用令牌端点,在令牌过期前约 60 秒将其缓存,并在下游调用中附加 Authorization: Bearer <token>。
  2. mTLS——BACEN 要求 Pix v2 使用双向 TLS,C6 也在所有产品系列中强制执行此要求。服务从你设置的路径加载客户端证书和私钥,构建 Node https.Agent,并通过该代理路由每个请求。

商户合同签署后,可从 C6 开发者门户获取证书和密钥包。

运行

# stdio (default)
npx @codespar/mcp-c6

注意事项

  • 路径尚未验证。 请查看 src/index.ts 中的 TODO(verify) 标记。已完成接入的商户应根据门户提供的 OpenAPI 规范进行验证,并提交 PR。
  • 沙盒主机名是猜测的。 C6 会为每个商户提供一个沙盒子域名;如果你获得的沙盒 URL 不同,请编辑 BASE_URL 进行覆盖。

企业版

需要为 Agent 付款提供治理、预算限制和审计记录?CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

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

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