mcpField
M
mcp-epayco

mcp-epayco

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

关于 mcp-epayco

mcp-epayco 是面向哥伦比亚支付网关 ePayco 的 MCP 服务，覆盖卡片令牌化与扣款、PSE 银行转账以及现金网点支付。工具集对应官方 epayco-node SDK 的接口，并通过 EPAYCO_TEST 参数标记测试模式。

主要功能

  1. 01卡片令牌化与客户创建
  2. 02卡片扣款与交易详情查询
  3. 03PSE 银行扣款与状态查询
  4. 04现金支付凭证生成
  5. 05支持测试模式标记

适用场景

  1. 01在 AI Agent 中为哥伦比亚线上商户发起卡片扣款
  2. 02查询 PSE 交易状态并获取银行跳转链接
  3. 03为现金网点支付生成付款凭证

MCP 相关

该服务以 MCP 服务形式向客户端暴露 8 个工具，用于调用 ePayco 的卡片、PSE 与现金支付接口。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-epayco": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-epayco"
      ],
      "env": {
        "EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
        "EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
        "EPAYCO_TEST": "<EPAYCO_TEST>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-epayco
需要配置的环境变量
EPAYCO_PUBLIC_KEY密钥ePayco public key
EPAYCO_PRIVATE_KEY密钥ePayco private key
EPAYCO_TEST"true" flags payloads as test mode. Defaults to "true" — set "false" for production.

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

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

工具

8

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

参数类型必填说明
cvcstring是银行卡 CVC
exp_yearstring是到期年份，例如 2027
exp_monthstring是到期月份，例如 09
card_numberstring是银行卡 PAN

详细介绍

@codespar/mcp-epayco

ePayco 的 MCP 服务——哥伦比亚支付网关（归 Davivienda 所有）：银行卡令牌化与扣款、PSE 银行扣款，以及现金支付网络（Efecty、Gana、Red Servi、Punto Red、Su Red）。

npm License: MIT

工具集与官方 ePayco SDK（epayco-node）一致：使用 api.secure.payco.co 的银行卡／令牌 API，以及使用 secure.payco.co 处理 PSE 和现金支付的 restpagos API。测试模式通过负载标志（EPAYCO_TEST）启用，而不是使用单独的主机。

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "epayco": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-epayco"],
      "env": {
        "EPAYCO_PUBLIC_KEY": "your-public-key",
        "EPAYCO_PRIVATE_KEY": "your-private-key",
        "EPAYCO_TEST": "true"
      }
    }
  }
}
Claude Code
claude mcp add epayco --env EPAYCO_PUBLIC_KEY=pk --env EPAYCO_PRIVATE_KEY=sk -- npx -y @codespar/mcp-epayco

工具（8 个）

工具描述
tokenize_card创建银行卡令牌（POST /v1/tokens）
create_customer创建与银行卡令牌绑定的客户
charge_card向令牌化银行卡扣款（POST /payment/v1/charge/create）
get_transaction根据 referencePayco 获取交易详情
create_pse_paymentPSE 银行扣款——返回银行重定向 URL
get_pse_transaction根据交易 ID 获取 PSE 交易状态
list_pse_banksPSE 银行列表
create_cash_payment创建 efecty / gana / redservi / puntored / sured 现金付款凭证

环境变量

变量必填描述
EPAYCO_PUBLIC_KEY是公钥
EPAYCO_PRIVATE_KEY是私钥
EPAYCO_TEST否"true"（默认值）会将负载标记为测试模式

文档

企业版

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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