mcp-khipu

Name: mcp-khipu
Author: codespar

本地服务

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

代码仓库

关于 mcp-khipu

mcp-khipu 是智利 Khipu 即时银行转账支付的 MCP 服务，可与 mcp-transbank 搭配使用。它面向需要银行转账收款的智利商户和代理，支持付款、退款、对账、Webhook 和 POS 终端会话。

主要功能

01创建、查询、确认与退款付款
02按日期和状态筛选付款记录
03银行与收款账户查询
04对账记录与付款评价查询
05Webhook 注册与管理
06POS 终端会话与自动付款

适用场景

01智利电商结账时提供银行转账付款方式
02大额采购与 B2B 收款
03与 Transbank 卡支付组合提供多种支付方式

MCP 相关

该服务以 MCP 服务的形式暴露 Khipu 的付款、商户、Webhook 和终端会话接口，MCP 客户端可直接调用这些工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-khipu": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-khipu"
      ],
      "env": {
        "KHIPU_API_KEY": "<KHIPU_API_KEY>",
        "KHIPU_RECEIVER_ID": "<KHIPU_RECEIVER_ID>",
        "KHIPU_SECRET": "<KHIPU_SECRET>",
        "KHIPU_BASE_URL": "<KHIPU_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-khipu

需要配置的环境变量

KHIPU_API_KEY密钥Khipu v3 API key (sent as x-api-key header). Obtain from Khipu merchant panel → Developers.

KHIPU_RECEIVER_IDKhipu receiver id (merchant id). Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.

KHIPU_SECRET密钥Khipu receiver secret. Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.

KHIPU_BASE_URLKhipu API base URL. Defaults to https://payment-api.khipu.com/v3.

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

安装包

npm@codespar/mcp-khipu0.2.0-alpha.3stdio

工具

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

参数	类型	必填	说明
body	string	否	较长的付款说明（与主题一同显示）
amount	number	是	以主要货币单位表示的金额（CLP 没有小数位——1000 = 1000 比索）
custom	string	否	任意商户字符串（需要结构化内容时使用 JSON 编码），会在 Webhook 中原样返回
subject	string	是	简短、易读的付款用途（向付款人的银行显示）
currency	string	是	ISO-4217 货币代码。智利通常使用 CLP；也支持以 UF 计价的收费使用 CLF。
cancel_url	string	否	付款人取消时的浏览器重定向目标
notify_url	string	否	状态变更时 Khipu POST 到的 Webhook URL（接收 notification_token）
payer_name	string	否	付款人显示名称
return_url	string	否	付款成功后的浏览器重定向目标
send_email	boolean	否	如果为 true，Khipu 会向付款人发送包含付款链接的电子邮件
payer_email	string	否	付款人电子邮件地址 — Khipu 会将付款说明发送到此地址
expires_date	string	否	此付款请求的 ISO-8601 过期时间戳
integrator_fee	number	否	集成商费用（适用于合作伙伴）
send_reminders	boolean	否	如果为 true，Khipu 会在过期前向付款人发送提醒邮件
transaction_id	string	否	商户端订单参考号，会在 Webhook 中原样返回
notify_api_version	string	否	Webhook API 版本。对于 v3 通知，请使用 '3.0'。
collect_account_uuid	string	否	覆盖默认收款账户
confirm_timeout_date	string	否	未确认付款自动撤销的 ISO-8601 截止时间
responsible_user_email	string	否	在 Khipu 控制面板中显示为此笔扣款负责人的内部商户用户电子邮件地址
fixed_payer_personal_identifier	string	否	将此付款锁定为特定付款人的 RUT

详细介绍

@codespar/mcp-khipu

适用于 Khipu 的 MCP 服务——智利即时银行转账支付服务提供商（PSP）。

Khipu 支持付款人实时通过智利银行账户付款：商户创建支付后，付款人会跳转至 Khipu，登录银行账户，转账随即到账。无需银行卡、无需信用额度，也没有交换费——这是智利消费者购买高价商品时的首选支付方式。

智利的 Agent 通常会将 Khipu 与 @codespar/mcp-transbank 搭配使用：Webpay 用于银行卡支付，Khipu 用于银行转账。两者结合可满足绝大多数智利消费者的结账偏好。

工具（21 个）

工具	用途
`create_payment`	创建 Khipu 支付（银行转账收款）。
`get_payment`	获取 Khipu 支付信息。
`delete_payment`	删除（取消）待处理的 Khipu 支付。
`confirm_payment`	手动确认 Khipu 支付。
`refund_payment`	退还已支付的 Khipu 款项（全额或部分）。
`list_payments`	列出当前商户的 Khipu 支付，可按日期范围和状态筛选。
`predict_payment`	预测指定付款人、金额和银行的支付是否可能成功，并推荐最佳银行/r...
`get_merchants`	列出使用当前 API 密钥可访问的商户收款账户。
`get_merchant`	按 ID 获取单个商户。
`list_merchant_accounts`	列出已注册用于接收商户款项的银行账户。
`create_receiver`	在集成商账户下创建（入驻）新的收款方。
`list_receivers`	列出在当前集成商账户下入驻的收款方。
`list_conciliations`	列出指定日期范围的结算/对账记录。
`list_reviews`	列出 Khipu 支付后付款人留下的评价/意见。
`register_webhook`	注册 Webhook 端点以接收 Khipu 通知（payment.paid、payment.refunded 等）。
`list_webhooks`	列出当前商户已注册的 Webhook 端点。
`delete_webhook`	按 ID 删除（注销）Webhook 端点。
`create_terminal_session`	创建 Khipu 终端会话，用于线下/POS 银行转账结账。
`get_terminal_session`	获取终端（POS）会话的当前状态——付款人是否已扫码、已付款，或会话是否已...
`get_banks`	列出 Khipu 支持用于银行转账支付的智利银行。
`create_automatic_payment`	创建 Khipu 自动支付（针对先前注册的订阅创建周期性/订阅扣款...

安装

npm install @codespar/mcp-khipu@alpha

环境

# Preferred — v3 API key auth
KHIPU_API_KEY="..."       # sent as x-api-key header

# Legacy — v2 HTTP Basic auth (only if no API key available)
KHIPU_RECEIVER_ID="..."   # merchant receiver id
KHIPU_SECRET="..."        # receiver secret

# Optional
KHIPU_BASE_URL="..."      # defaults to https://payment-api.khipu.com/v3

身份验证

Khipu v3 使用 x-api-key 标头中的单个 API 密钥——无需请求签名或 HMAC。可在 Khipu 商户面板的 Developers → API keys 中获取密钥。

如果未设置 KHIPU_API_KEY，服务会回退到 v2 HTTP Basic 身份验证，使用 KHIPU_RECEIVER_ID:KHIPU_SECRET，供仍在使用旧版端点的商户使用。

所有请求正文均为 JSON（v3）；服务会自动设置 Content-Type: application/json。

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-khipu

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-khipu

为什么搭配使用 Khipu 和 Transbank

智利有两种主流结账方式：

银行卡（Transbank Webpay）——适用范围广，几乎随处可用，但需支付交换费。
银行转账（Khipu）——无需银行卡或信用额度，费用更低，是大额购买和 B2B 交易的首选。

结账时能同时提供这两种方式的 Agent，其转化效果明显优于只支持银行卡支付的 Agent。@codespar/mcp-transbank 负责第一种方式；此软件包负责第二种方式。

搭配使用

@codespar/mcp-transbank — 智利银行卡收单（Webpay Plus、Oneclick、Full Transaction）
@codespar/mcp-dlocal — 通过一个 API 覆盖智利及其他国家/地区的拉美跨境业务

企业版

需要为 Agent 支付提供治理、预算限制和审计跟踪？CodeSpar Enterprise 可在这些 MCP 服务的基础上增加策略引擎、支付路由和合规模板。

许可证

MIT

支持 Markdown

登录后评论

基本信息

作者: codespar
语言: node
版本: 0.2.0-alpha.3
传输方式: stdio
收录时间: 2026年6月22日
最近更新: 5 周前
官方 Registry: io.github.codespar/mcp-khipu

报告问题

第一次接触 MCP？

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

阅读入门指南

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

mcp-khipu

关于 mcp-khipu

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

@codespar/mcp-khipu

工具（21 个）

安装

环境

身份验证

运行

为什么搭配使用 Khipu 和 Transbank

搭配使用

企业版

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？