mcp-server-alipay 是支付宝官方提供的 MCP Server 组件，专为 AI 应用设计。它使开发者能够轻松地将支付宝核心支付能力，如交易创建、状态查询和退款处理，无缝集成到基于大型语言模型 (LLM) 的智能工具或 Agent 中。通过标准的模型上下文协议 (MCP)，AI 模型可以直接调用这些支付功能，极大地简化了传统支付 API 的集成复杂性，解决了开发者在 AI 应用中实现支付功能的痛点。其核心价值在于赋能 AI 应用处理真实的金融交易，实现自动化和智能化的支付流程。开发者只需通过环境变量进行简单配置，即可将其部署于兼容的 MCP Client 环境（如 Cursor、Cline）中，快速为 AI 应用添加强大的支付宝支付功能。

支付宝交易创建

mcp-server-alipay 的核心能力之一是允许AI模型通过标准化的MCP接口创建支付宝交易。该功能通过两个具体的MCP工具实现：create-mobile-alipay-payment 和 create-web-page-alipay-payment。前者适用于移动端场景，生成可直接唤起支付宝App或在手机浏览器内完成支付的链接；后者则适用于PC端场景，生成供用户扫码支付的二维码链接。AI模型或Agent在需要收款时，可以调用这两个工具之一，提供必要的参数，如商户订单号 (outTradeNo)、订单总金额 (totalAmount，单位元) 和订单标题 (orderTitle)。Server接收到请求后，会与支付宝开放平台API交互，生成对应的支付凭证，并将其封装成Markdown格式的链接返回给AI。这极大地简化了开发者在AI应用中集成支付发起的流程，使AI能够根据上下文自动生成支付请求，无需开发者编写复杂的支付API调用和签名逻辑。例如，一个电商导购AI可以根据用户选择的商品，自动计算总价并调用此工具生成支付链接，实现从推荐到下单支付的闭环。

交易与退款状态查询

为了实现支付流程的自动化和智能化，仅仅能够创建交易是不够的，还需要能够准确地追踪交易和退款的状态。mcp-server-alipay 提供了 query-alipay-payment 和 query-alipay-refund 两个MCP工具来满足这一需求。query-alipay-payment 工具允许AI模型通过提供商户订单号 (outTradeNo) 来查询特定支付宝订单的支付状态（如 TRADE_SUCCESS, WAIT_BUYER_PAY 等）、支付金额和支付宝交易号。query-alipay-refund 工具则允许通过提供退款请求号 (outRequestNo) 和原商户订单号 (outTradeNo) 来查询退款的处理状态（如 REFUND_SUCCESS）和退款金额。这些查询能力对于AI Agent至关重要，使其能够确认用户是否已成功支付，以便触发后续服务（如发货、交付虚拟商品），或确认退款是否已成功处理，以便更新订单状态或通知用户。例如，一个自动服务开通Agent可以在生成支付链接后，周期性调用 query-alipay-payment，直到状态变为 TRADE_SUCCESS 才自动为用户开通服务。

支付宝交易退款

除了创建和查询交易，处理退款也是支付场景中的常见需求。mcp-server-alipay 通过 refund-alipay-payment 工具，赋予了AI模型直接发起支付宝交易退款的能力。开发者可以通过配置，让AI Agent在接收到用户的退款请求或满足特定退款条件时，调用此工具。调用时需要提供关键参数，包括需要退款的原商户订单号 (outTradeNo)、退款金额 (refundAmount，单位元)、标识单次退款请求的商户退款请求号 (outRequestNo，用于幂等控制和后续查询) 以及可选的退款原因 (refundReason)。Server收到请求后，会调用支付宝的退款接口执行操作，并返回支付宝交易号和退款结果指示（通常表示退款请求已受理）。这使得AI应用能够自动化处理部分或全部退款流程，减少人工客服的介入。例如，一个处理订阅服务的AI Agent，在用户取消订阅且符合退款策略时，可以自动调用 refund-alipay-payment 工具发起相应费用的退款。