AI导哈

Antom支付协议服务

Antom MCP Server是一个兼容模型上下文协议（MCP）的服务，集成了Ant International的Antom支付API，使AI助手能够无缝处理支付和退款操作。该服务将Antom支付API封装为标准化的MCP工具，允许AI助手在对话中安全地处理支付相关操作，包括创建支付会话、查询交易状态、处理退款等。

  • by caixinfeng
  • 更新于
在 GitHub 查看 alipay/global-antom-mcp

使用说明

基本能力

产品定位

Antom MCP Server是一个支付协议服务，专为AI助手设计，用于处理支付和退款操作。

核心功能

  • 支付操作

    • 创建支付会话 (create_payment_session): 为客户端SDK集成生成支付会话
    • 查询支付详情 (query_payment_detail): 检索提交的支付请求的交易状态和信息
    • 取消支付 (cancel_payment): 在预期时间内未返回结果时取消支付

  • 退款操作

    • 创建退款 (create_refund): 对成功的支付发起全额或部分退款
    • 查询退款详情 (query_refund_detail): 检查之前提交的退款请求的状态

适用场景

  • AI助手集成支付功能
  • 电子商务平台需要自动化支付处理
  • 需要退款管理的服务

使用教程

使用依赖

在安装Antom MCP Server之前，请确保您具备以下条件：

  • Python 3.11或更高版本
  • uv（推荐包管理器）或pip
  • 有效的Antom商户账户，包括：
    • 商户客户端ID (CLIENT_ID)
    • 商户RSA私钥 (MERCHANT_PRIVATE_KEY)
    • 支付宝RSA公钥 (ALIPAY_PUBLIC_KEY)
    • 支付完成后的重定向URL (PAYMENT_REDIRECT_URL)
    • 支付结果通知回调URL (PAYMENT_NOTIFY_URL)

安装教程

使用uvx直接安装（推荐）

uvx ant-intl-antom-mcp

从源代码安装

git clone https://github.com/alipay/global-antom-mcp.git
cd global-antom-mcp
uv install

调试方式

MCP客户端配置

将以下配置添加到您的MCP客户端：

{
  "mcpServers": {
    "antom-mcp-server": {
      "command": "uvx",
      "args": ["ant-intl-antom-mcp"],
      "env": {
        "GATEWAY_URL": "https://open-sea-global.alipay.com",
        "CLIENT_ID": "your_client_id_here",
        "MERCHANT_PRIVATE_KEY": "your_merchant_private_key_here",
        "ALIPAY_PUBLIC_KEY": "your_alipay_public_key_here",
        "PAYMENT_REDIRECT_URL": "/",
        "PAYMENT_NOTIFY_URL": "https://your-domain.com/payment/notify"
      }
    }
  }
}

环境变量

变量 是否必需 描述
GATEWAY_URL ❌ Antom API网关URL（默认为https://open-sea-global.alipay.com）
CLIENT_ID ✅ 用于身份验证的商户客户端ID
MERCHANT_PRIVATE_KEY ✅ 用于请求签名的商户RSA私钥
ALIPAY_PUBLIC_KEY ✅ 用于响应验证的支付宝RSA公钥
PAYMENT_REDIRECT_URL ❌ 支付完成后用户被重定向到的URL
PAYMENT_NOTIFY_URL ❌ 支付结果通知回调URL

相关 MCP