mcp-nequi

Name: mcp-nequi
Author: codespar

本地服务

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

代码仓库

关于 mcp-nequi

mcp-nequi 是面向哥伦比亚数字钱包 Nequi 的 MCP 服务，提供推送支付、二维码支付和订阅相关工具。README 标注为 alpha 版本，端点尚未完全经过线上验证。

主要功能

01推送支付通知与支付状态查询
02生成动态及静态二维码支付
03订阅查询与取消
04支付冲正与交易冲正
05商户余额、结算与交易列表查询
06支持沙箱与生产环境切换

适用场景

01为商户发起 Nequi 推送付款并跟踪状态
02生成门店固定二维码用于收款
03查询结算记录并核对交易流水

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-nequi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-nequi"
      ],
      "env": {
        "NEQUI_API_KEY": "<NEQUI_API_KEY>",
        "NEQUI_CLIENT_ID": "<NEQUI_CLIENT_ID>",
        "NEQUI_CLIENT_SECRET": "<NEQUI_CLIENT_SECRET>"
      }
    }
  }
}

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

需要配置的环境变量

NEQUI_API_KEY密钥API key for Nequi

NEQUI_CLIENT_IDOAuth2 client ID

NEQUI_CLIENT_SECRET密钥OAuth2 client secret

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

安装包

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

工具

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

参数	类型	必填	说明
code	string	是	商户支付代码
value	string	是	以 COP 计价的支付金额
message	string	否	支付消息／说明
merchant_id	string	否	商家 ID
phone_number	string	是	Nequi 电话号码（10 位数字）

详细介绍

MCP Nequi

Alpha 版本 — 通过 alpha npm dist-tag 发布。端点路径遵循公开文档及 BACEN/提供商惯例，但尚未经过全面的线上验证。在 0.x.x-alpha 期间，请固定使用确切版本。使用 npm install <pkg>@alpha 安装。

Nequi MCP 服务——哥伦比亚领先的数字钱包，拥有 5,000 多万用户，由 Bancolombia 提供支持。支持推送支付、QR 支付和订阅。

快速开始

# Set your credentials
export NEQUI_API_KEY="your-api-key"
export NEQUI_CLIENT_ID="your-client-id"
export NEQUI_CLIENT_SECRET="your-client-secret"

# Run via stdio
npx tsx packages/colombia/nequi/src/index.ts

# Run via HTTP
npx tsx packages/colombia/nequi/src/index.ts --http

环境变量

变量	必需	说明
`NEQUI_API_KEY`	是	从 Nequi 开发者门户获取的 API 密钥
`NEQUI_CLIENT_ID`	是	OAuth2 客户端 ID
`NEQUI_CLIENT_SECRET`	是	OAuth2 客户端密钥
`NEQUI_ENV`	否	`"sandbox"` 或 `"production"`（默认值：sandbox）
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（16 个）

工具	用途
`create_push_payment`	向 Nequi 用户发送推送支付通知
`get_payment_status`	查看支付状态
`create_qr_payment`	生成支付 QR 码
`reverse_payment`	撤销已完成的支付
`get_subscription`	获取电话号码对应的订阅详情
`unsubscribe`	取消订阅
`create_static_qr`	为商户生成静态（可重复使用的）Nequi QR 码
`reverse_transaction`	根据交易 ID 撤销任何 Nequi 交易（退款流程）
`validate_phone`	检查电话号码是否已注册 Nequi
`notify_unregistered_payment`	通知尚未使用 Nequi 的收款人，并说明如何领取款项
`list_transactions`	列出指定日期范围内商户的交易
`get_balance`	获取商户自己的 Nequi 账户余额
`schedule_payment`	为未来日期安排 Nequi 推送支付
`authorize_recurring_charge`	授权针对 Nequi 用户的定期扣款协议
`get_merchant_info`	获取已注册商户的企业资料
`get_settlement`	查询指定日期的结算（清算）信息