mcpField
M
mcp-kushki

mcp-kushki

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

关于 mcp-kushki

mcp-kushki 是 Kushki 支付服务的 MCP 服务，Kushki 是覆盖墨西哥、哥伦比亚、智利、秘鲁和厄瓜多尔的 PSP。它通过一套 REST API 提供卡支付、预授权、PSE/SPEI 银行转账、现金网络和订阅功能，适合需要在拉美市场处理收款的开发者与 Agent。

主要功能

  1. 01卡片令牌化与单步收款
  2. 02两步式预授权与部分捕获
  3. 03PSE 与 SPEI 银行转账收款
  4. 04现金凭证收款
  5. 05周期性卡片订阅与取消

适用场景

  1. 01让 Agent 在测试环境中为卡片创建收款
  2. 02在哥伦比亚以 COP 收取含 IVA 的款项
  3. 03为订阅服务创建或取消周期性扣款

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-kushki": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-kushki"
      ],
      "env": {
        "KUSHKI_PUBLIC_MERCHANT_ID": "<KUSHKI_PUBLIC_MERCHANT_ID>",
        "KUSHKI_PRIVATE_MERCHANT_ID": "<KUSHKI_PRIVATE_MERCHANT_ID>",
        "KUSHKI_ENV": "<KUSHKI_ENV>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-kushki
需要配置的环境变量
KUSHKI_PUBLIC_MERCHANT_ID密钥Kushki public merchant id (card/transfer tokenization)
KUSHKI_PRIVATE_MERCHANT_ID密钥Kushki private merchant id (charges, captures, voids, subscriptions)
KUSHKI_ENVEnvironment: 'sandbox' (api-uat) or 'production'. Defaults to 'sandbox'.

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

安装包
npm@codespar/mcp-kushki0.1.0

工具

10

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

参数类型必填说明
cardobject是卡片数据
card.cvvstring是安全码
card.namestring是持卡人姓名
card.numberstring是卡号（PAN）
card.expiryYearstring是YY
card.expiryMonthstring是MM
currencystring是MXN | COP | CLP | PEN | USD
totalAmountnumber是令牌将扣取的总金额

详细介绍

@codespar/mcp-kushki

面向 Kushki 的 MCP 服务——覆盖墨西哥、哥伦比亚、智利、秘鲁和厄瓜多尔的全渠道 PSP：通过单一 REST API 提供银行卡令牌化、单步／两步扣款、银行转账入账（PSE / SPEI）、现金网络和订阅服务。

npm License: MIT

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "kushki": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-kushki"],
      "env": {
        "KUSHKI_PUBLIC_MERCHANT_ID": "your-public-merchant-id",
        "KUSHKI_PRIVATE_MERCHANT_ID": "your-private-merchant-id",
        "KUSHKI_ENV": "sandbox"
      }
    }
  }
}
Claude Code
claude mcp add kushki --env KUSHKI_PUBLIC_MERCHANT_ID=... --env KUSHKI_PRIVATE_MERCHANT_ID=... -- npx -y @codespar/mcp-kushki
Cursor / VS Code

将相同的代码块添加到 .cursor/mcp.json 或 .vscode/mcp.json。

工具（10 个）

工具端点功能
tokenize_cardPOST /card/v1/tokens原始银行卡信息 → 一次性令牌（公开 ID）
create_chargePOST /card/v1/charges单步银行卡扣款
create_preauthorizationPOST /card/v1/preAuthorization冻结资金（两步流程，第 1 步）
capture_preauthorizationPOST /card/v1/capture完成预授权扣款（第 2 步，支持部分扣款）
void_chargeDELETE /card/v1/charges/{ticket}撤销（当日）或退款（已结算）
create_transfer_tokenPOST /transfer/v1/tokens用于 PSE（CO）／SPEI（MX）转账入账的令牌
create_transfer_chargePOST /transfer/v1/init发起银行转账；返回重定向 URL
create_cash_chargePOST /cash/v1/charges适用于 OXXO 等网络的现金付款凭证
create_subscriptionPOST /card/v1/subscriptions按周期进行银行卡定期扣款
cancel_subscriptionDELETE /card/v1/subscriptions/{id}停止后续扣款

身份验证

两个具有不同权限的商户 ID：

变量必填说明
KUSHKI_PUBLIC_MERCHANT_ID是仅用于令牌化，可安全用于客户端
KUSHKI_PRIVATE_MERCHANT_ID是用于资金转移，仅限服务端使用
KUSHKI_ENV否sandbox（api-uat，默认）或 production

金额采用 Kushki 按国家/地区区分的税额格式：{ subtotalIva, subtotalIva0, iva, currency }——币种包括 MXN、COP、CLP、PEN、USD。

示例

“将这张测试银行卡令牌化，并扣款 COP 85,000，含 19% 的 IVA。”

Agent 会调用 tokenize_card，然后使用 { subtotalIva: 85000, subtotalIva0: 0, iva: 16150, currency: "COP" } 调用 create_charge。

企业版

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

托管版

这个开源服务使用你的凭证直接调用 Kushki 的 API。CodeSpar 的托管版通过统一接口连接所有 LATAM 服务商，并提供自动故障转移、治理、审计和凭证保险库：codespar.dev/agents。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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