支付宝 MCP

支付宝 MCP

@alipay/mcp-server-alipay 是支付宝开放平台提供的 MCP Server,让你可以轻松将支付宝开放平台提供的交易创建、查询、退款等能力集成到你的 LLM 应用中,并进一步创建具备支付能力的智能工具。

@alipay/mcp-server-alipay 是支付宝开放平台提供的 MCP Server,让你可以轻松将支付宝开放平台的交易创建、查询、退款等能力集成到 LLM 应用中,创建具备支付能力的智能工具。

前置条件

  • 成为支付宝开放平台的收款商户
  • 获取商户私钥和相关配置信息

配置与使用

在 Cursor 中配置

.cursor/mcp.json 文件中添加:

{
  "mcpServers": {
    "mcp-server-alipay": {
      "command": "npx",
      "args": ["-y", "@alipay/mcp-server-alipay"],
      "env": {
        "AP_APP_ID": "2014...222",
        "AP_APP_KEY": "MIIE...DZdM=",
        "AP_PUB_KEY": "MIIB...DAQAB",
        "AP_RETURN_URL": "https://success-page",
        "AP_NOTIFY_URL": "https://your-own-server"
      }
    }
  }
}

在 Cline 中配置

cline_mcp_settings.json 文件中添加:

{
  "mcpServers": {
    "mcp-server-alipay": {
      "command": "npx",
      "args": ["-y", "@alipay/mcp-server-alipay"],
      "env": {
        "AP_APP_ID": "2014...222",
        "AP_APP_KEY": "MIIE...DZdM=",
        "AP_PUB_KEY": "MIIB...DAQAB",
        "AP_RETURN_URL": "https://success-page",
        "AP_NOTIFY_URL": "https://your-own-server"
      },
      "disable": false,
      "autoApprove": []
    }
  }
}

环境变量参数

# 必需参数
AP_APP_ID=2014...222                    # 商户应用ID
AP_APP_KEY=MIIE...DZdM=                 # 商户应用私钥
AP_PUB_KEY=MIIB...DAQAB                 # 支付宝公钥

# 可选参数
AP_RETURN_URL=https://success-page      # 同步结果返回地址
AP_NOTIFY_URL=https://your-own-server   # 异步结果通知地址
AP_ENCRYPTION_ALGO=RSA2                 # 签名方式(RSA2/RSA),默认RSA2
AP_CURRENT_ENV=prod                     # 环境设置(prod/sandbox),默认prod
AP_SELECT_TOOLS=all                     # 启用工具,默认all
AP_LOG_ENABLED=true                     # 是否记录日志,默认true

调试方法

使用 MCP Inspector 进行调试:

# 1. 设置环境变量
# 2. 启动Inspector
npx -y @modelcontextprotocol/inspector npx -y @alipay/mcp-server-alipay
# 3. 在WebUI中调试

支持的能力

功能工具名称描述主要参数
H5支付h5Pay创建手机网站支付订单outTradeNo, totalAmount, orderTitle
PC支付pcPay创建PC网页支付订单outTradeNo, totalAmount, orderTitle

注意事项