基本能力
产品定位
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 |
