mcp-wompi

Name: mcp-wompi
Author: codespar

本地服务

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

代码仓库

关于 mcp-wompi

mcp-wompi 是哥伦比亚支付网关 Wompi（由 Bancolombia 运营）的 MCP 服务。适合需要在 Agent 中处理卡支付、PSE 银行转账、Nequi 等哥伦比亚支付方式的开发者。服务提供 22 个工具，覆盖交易、支付链接、令牌化、退款和 webhook 签名验证。

主要功能

01卡、PSE、Nequi 等支付方式的交易处理
02支付链接的创建与管理
03卡与 Nequi 的令牌化及支付来源管理
04退款创建与查询
05客户档案与 PSE 银行列表查询
06webhook 签名验证

适用场景

01让 Agent 为订单创建支付链接并跟踪交易状态
02按商户参考号查找交易并执行作废或退款
03为可重复使用的支付来源创建客户档案与令牌

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 Wompi 的 22 个支付相关工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-wompi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-wompi"
      ],
      "env": {
        "WOMPI_PUBLIC_KEY": "<WOMPI_PUBLIC_KEY>",
        "WOMPI_PRIVATE_KEY": "<WOMPI_PRIVATE_KEY>",
        "WOMPI_EVENTS_SECRET": "<WOMPI_EVENTS_SECRET>"
      }
    }
  }
}

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

需要配置的环境变量

WOMPI_PUBLIC_KEY密钥Public key for Wompi

WOMPI_PRIVATE_KEY密钥Private key for Wompi

WOMPI_EVENTS_SECRET密钥Events/webhook secret for signature validation

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

安装包

npm@codespar/mcp-wompi0.2.2stdio

工具

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

参数	类型	必填	说明
currency	string	是	货币代码（COP）
reference	string	是	唯一交易引用
customer_data	object	否	客户数据
customer_data.legal_id	string	否	法定 ID（cedula）
customer_data.full_name	string	否	全名
customer_data.phone_number	string	否	电话号码
customer_data.legal_id_type	string	否	法定 ID 类型（CC、NIT、CE）
customer_email	string	是	客户电子邮件
payment_method	object	是	支付方式详情
payment_method.type	string	是	付款类型（CARD、NEQUI、PSE、BANCOLOMBIA_TRANSFER）
payment_method.token	string	否	令牌化卡片令牌（用于 CARD）
payment_method.user_type	number	否	用户类型：0=自然人，1=法人（适用于 PSE）
payment_method.installments	number	否	分期付款次数（适用于 CARD）
payment_method.phone_number	string	否	电话号码（适用于 NEQUI）
payment_method.payment_description	string	否	描述（适用于 PSE）
payment_method.financial_institution_code	string	否	银行代码（适用于 PSE）
amount_in_cents	number	是	金额（以分为单位，COP）
acceptance_token	string	否	来自 get_acceptance_token 的接受令牌

详细介绍

@codespar/mcp-wompi

面向 Wompi 的 MCP 服务。Wompi 是 Bancolombia 的哥伦比亚支付网关，支持银行卡、PSE 银行转账、Nequi 和 Bancolombia 转账

快速开始

# Set your credentials
export WOMPI_PUBLIC_KEY="pub_test_..."
export WOMPI_PRIVATE_KEY="prv_test_..."
export WOMPI_SANDBOX="true"

# Run via stdio
npx -y @codespar/mcp-wompi

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

环境变量

变量	必需	描述
`WOMPI_PUBLIC_KEY`	是	Wompi 控制面板中的公钥
`WOMPI_PRIVATE_KEY`	是	用于服务端操作的私钥
`WOMPI_SANDBOX`	否	设置为 `"true"` 以使用沙盒环境
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（22 个）

工具	用途
`create_transaction`	创建支付交易
`get_transaction`	根据 ID 获取交易详情
`list_transactions`	列出交易
`search_transaction_by_reference`	根据商户参考编号查找交易
`void_transaction`	撤销交易
`create_payment_link`	创建支付链接
`get_payment_link`	获取支付链接详情
`update_payment_link`	更新支付链接
`list_payment_links`	列出支付链接
`list_payment_methods`	列出商户可用的支付方式
`get_acceptance_token`	获取商户接受令牌（交易必需）
`create_tokenized_card`	将信用卡/借记卡令牌化
`create_tokenized_nequi`	将 Nequi 钱包令牌化（通过电话号码启动异步令牌化）
`get_tokenization_status`	根据令牌化 ID 查询异步令牌化状态（如 Nequi）
`create_payment_source`	创建可重复使用的支付来源（CARD/NEQUI/PSE），并关联客户邮箱
`create_customer`	创建客户资料
`get_customer`	根据 ID 获取客户
`list_financial_institutions`	列出 PSE 银行（金融机构）
`create_refund`	为交易创建退款
`get_refund`	根据 ID 获取退款详情
`get_merchant`	获取商户信息
`validate_webhook_signature`	验证 Wompi 事件签名。