Skip to content

Commit 9483a57

Browse files
lowkeyrdlowkeyrd
authored
Merge pull request #50 from devsapp/lzw-test
Lzw test
2 parents ac308a8 + a3145de commit 9483a57

11 files changed

Lines changed: 732 additions & 0 deletions

File tree

‎start-mcp-server-alipay/README.md‎

Lines changed: 225 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,225 @@
1+
2+
> 注：当前项目为 Serverless Devs 应用，由于应用中会存在需要初始化才可运行的变量（例如应用部署地区、函数名等等），所以**不推荐**直接 Clone 本仓库到本地进行部署或直接复制 s.yaml 使用，**强烈推荐**通过 `s init ${模版名称}` 的方法或应用中心进行初始化，详情可参考[部署 & 体验](#部署--体验) 。
3+
4+
# start-mcp-server-alipay 帮助文档
5+
6+
<description>
7+
8+
支付宝 MCP Server
9+
10+
</description>
11+
12+
13+
## 资源准备
14+
15+
使用该项目，您需要有开通以下服务并拥有对应权限：
16+
17+
<service>
18+
19+
20+
21+
| 服务/业务 | 权限 | 相关文档 |
22+
| --- | --- | --- |
23+
| 函数计算 | AliyunFCFullAccess | [帮助文档](https://help.aliyun.com/product/2508973.html) [计费文档](https://help.aliyun.com/document_detail/2512928.html) |
24+
25+
</service>
26+
27+
<remark>
28+
29+
30+
31+
</remark>
32+
33+
<disclaimers>
34+
35+
36+
37+
</disclaimers>
38+
39+
## 部署 & 体验
40+
41+
<appcenter>
42+
43+
- :fire: 通过 [云原生应用开发平台 CAP](https://functionai.console.aliyun.com/template-detail?template=start-mcp-server-alipay) ，[![Deploy with Severless Devs](https://img.alicdn.com/imgextra/i1/O1CN01w5RFbX1v45s8TIXPz_!!6000000006118-55-tps-95-28.svg)](https://functionai.console.aliyun.com/template-detail?template=start-mcp-server-alipay) 该应用。
44+
45+
</appcenter>
46+
<deploy>
47+
48+
49+
</deploy>
50+
51+
## 案例介绍
52+
53+
<appdetail id="flushContent">
54+
55+
### 1. 简介
56+
57+
`@alipay/mcp-server-alipay` 是支付宝开放平台提供的 MCP Server，让你可以轻松将支付宝开放平台提供的交易创建、查询、退款等能力集成到你的 LLM 应用中，并进一步创建具备支付能力的智能工具。
58+
59+
以下是一个虚构的简化使用场景，用于方便理解工具能力：
60+
61+
> 一位插画师希望通过提供定制的原创插画服务谋取收入。传统方式下，他/她需要和每位客户反复沟通需求、确定价格，并发送支付链接，然后再人工确认支付情况，这个过程繁琐且费时。
62+
>
63+
> 现在，插画师利用支付宝 MCP Server 与智能 Agent 工具，通过 Agent 搭建平台，开发了一个智能聊天应用（网页或小程序）。客户只需在应用中描述自己的绘画需求（如风格偏好、插画用途、交付时间等），AI 就会自动分析需求，快速生成准确且合理的定制报价，并通过工具即时创建出专用的支付宝支付链接。
64+
>
65+
> 客户点击并支付后，创作者立即收到通知，进入创作环节。无需人工往返对话确认交易状态或支付情况，整个流程不仅便捷顺畅，还能显著提高交易效率和客户满意度，让插画师更专注于自己的创作本身，实现更轻松的个性化服务商业模式。
66+
67+
```
68+
最终用户设备 Agent 运行环境
69+
+---------------------+ +--------------------------+ +-------------------+
70+
| | 交流 | 支付宝 MCP Server + | | |
71+
| 小程序/WebApp |<------>| 其他 MCP Server + |<---->| 支付服务 |
72+
| | 支付 | Agent 开发工具 | | 交易/退款/查询 |
73+
+---------------------+ +--------------------------+ +-------------------+
74+
创作服务买家 智能工具开发者 支付宝开放平台
75+
(最终用户) (创作者)
76+
```
77+
78+
关于本工具的更多介绍和使用指南，包括准备收款商户身份等前置流程，请参考支付宝开放平台上的 [支付 MCP 服务文档](https://opendocs.alipay.com/open/0go80l) 。
79+
80+
### 2. 使用和配置
81+
82+
要使用工具的大部分支付能力，你需要先成为支付宝开放平台的收款商户，获取商户私钥。
83+
之后，你可以直接在主流的 MCP Client 上使用支付宝 MCP Server：
84+
85+
#### 在 Cursor 中使用
86+
87+
在 Cursor 项目中的 `.cursor/mcp.json` 加入如下配置：
88+
89+
```json
90+
{
91+
"mcpServers": {
92+
"mcp-server-alipay": {
93+
"command": "npx",
94+
"args": ["-y", "@alipay/mcp-server-alipay"],
95+
"env": {
96+
"AP_APP_ID": "2014...222",
97+
"AP_APP_KEY": "MIIE...DZdM=",
98+
"AP_PUB_KEY": "MIIB...DAQAB",
99+
"AP_RETURN_URL": "https://success-page",
100+
"AP_NOTIFY_URL": "https://your-own-server",
101+
"...其他参数": "...其他值"
102+
}
103+
},
104+
"其他工具": {
105+
"...": "..."
106+
}
107+
}
108+
}
109+
```
110+
111+
#### 在 Cline 中使用
112+
113+
在你的 Cline 设置中找到 `cline_mcp_settings.json` 配置文件，并加入如下配置：
114+
115+
```json
116+
{
117+
"mcpServers": {
118+
"mcp-server-alipay": {
119+
"command": "npx",
120+
"args": ["-y", "@alipay/mcp-server-alipay"],
121+
"env": {
122+
"AP_APP_ID": "2014...222",
123+
"AP_APP_KEY": "MIIE...DZdM=",
124+
"AP_PUB_KEY": "MIIB...DAQAB",
125+
"AP_RETURN_URL": "https://success-page",
126+
"AP_NOTIFY_URL": "https://your-own-server",
127+
"...其他参数": "...其他值"
128+
},
129+
"disable": false,
130+
"autoApprove": []
131+
},
132+
"其他工具": {
133+
"...": "..."
134+
}
135+
}
136+
}
137+
```
138+
139+
#### 在其他 MCP Client 中使用
140+
141+
你也可以在任何其它 MCP Client 中使用，合理配置 Server 进程启动方式 `npx -y @alipay/mcp-server-alipay`，并按下文介绍设置环境参数即可。
142+
143+
#### 所有参数
144+
145+
支付宝 MCP Server 通过环境变量接收参数。参数和默认值包括:
146+
147+
```shell
148+
# 支付宝开放平台配置
149+
150+
AP_APP_ID=2014...222 # 商户在开放平台申请的应用 ID（APPID）。必需。
151+
AP_APP_KEY=MIIE...DZdM= # 商户在开放平台申请的应用私钥。必需。
152+
AP_PUB_KEY=MIIB...DAQAB # 用于验证支付宝服务端数据签名的支付宝公钥，在开放平台获取。必需。
153+
AP_RETURN_URL=https://success-page # 网页支付完成后对付款用户展示的「同步结果返回地址」。
154+
AP_NOTIFY_URL=https://your-own-server # 支付完成后，用于告知开发者支付结果的「异步结果通知地址」。
155+
AP_CURRENT_ENV=prod # 连接的支付宝开放平台环境。可选值为 "prod"（线上环境）或 "sandbox"（沙箱环境）。缺省值为 "prod"。
156+
AP_INVOKE_AUTH_TOKEN=202504BBdd...X49 # 服务商三方代调用授权token，可选。
157+
158+
# MCP Server 配置
159+
160+
AP_SELECT_TOOLS=all # 允许使用的工具。可选值为 "all" 或逗号分隔的工具名称列表。工具名称包括 `create-mobile-alipay-payment`, `create-web-page-alipay-payment`, `query-alipay-payment`, `refund-alipay-payment`, `query-alipay-refund`。缺省值为 "all"。
161+
AP_LOG_ENABLED=true # 是否在 $HOME/mcp-server-alipay.log 中记录日志。默认值为 true。
162+
```
163+
164+
### 3. 使用 MCP Inspector 调试
165+
166+
你可以使用 MCP Inspector 来调试和了解支付宝 MCP Server 的功能：
167+
168+
1. 通过 `export` 设置各环境变量；
169+
2. 执行 `npx -y @modelcontextprotocol/inspector npx -y @alipay/mcp-server-alipay` 启动 MCP Inspector；
170+
3. 在 MCP Inspector WebUI 中调试即可。
171+
172+
## 4. 支持的能力
173+
174+
以下表格列出了所有可用的支付工具能力：
175+
176+
| 名称 | 描述 | 参数 | 输出 |
177+
|-------|------|------|------|
178+
| `create-mobile-alipay-payment` | 创建一笔支付宝订单，返回带有支付链接的 Markdown 文本，该链接在手机浏览器中打开后可跳转到支付宝或直接在浏览器中支付。本工具适用于移动网站或移动 App。 | - outTradeNo: 商户订单号，最长 64 个字符<br>- totalAmount: 支付金额，单位：元，最小 0.01<br>- orderTitle: 订单标题，最长 256 个字符 | - url: 支付链接的 markdown 文本 |
179+
| `create-web-page-alipay-payment` | 创建一笔支付宝订单，返回带有支付链接的 Markdown 文本，该链接在电脑浏览器中打开后会展示支付二维码，用户可扫码支付。本工具适用于桌面网站或电脑客户端。 | - outTradeNo: 商户订单号，最长 64 个字符<br>- totalAmount: 支付金额，单位：元，最小 0.01<br>- orderTitle: 订单标题，最长 256 个字符 | - url: 支付链接的 markdown 文本 |
180+
| `query-alipay-payment` | 查询一笔支付宝订单，并返回带有订单信息的文本 | - outTradeNo: 商户订单号，最长 64 个字符 | - tradeStatus: 订单的交易状态<br>- totalAmount: 订单的交易金额<br>- tradeNo: 支付宝交易号 |
181+
| `refund-alipay-payment` | 对交易发起退款，并返回退款状态和退款金额 | - outTradeNo: 商户订单号，最长 64 个字符<br>- refundAmount: 退款金额，单位：元，最小 0.01<br>- outRequestNo: 退款请求号，最长 64 个字符<br>- refundReason: 退款原因，最长 256 个字符（可选） | - tradeNo: 支付宝交易号<br>- refundResult: 退款结果 |
182+
| `query-alipay-refund` | 查询一笔支付宝退款，并返回退款状态和退款金额 | - outRequestNo: 退款请求号，最长 64 个字符<br>- outTradeNo: 商户订单号，最长 64 个字符 | - tradeNo: 支付宝交易号<br>- refundAmount: 退款金额<br>- refundStatus: 退款状态 |
183+
184+
### 5. 如何选择合适的支付方式
185+
186+
在开发过程中，为了让 LLM 能更准确地选择合适的支付方式，建议在 Prompt 中清晰说明你的产品使用场景：
187+
188+
- **网页支付（`create-web-page-alipay-payment`）**：适用于用户在电脑屏幕上看到支付界面的场景。如果您的应用或网站主要运行在桌面端（PC），你可以在 Prompt 中说明："我的应用是桌面软件/PC网站，需要在电脑上展示支付二维码"。
189+
190+
- **手机支付（`create-mobile-alipay-payment`）**：适用于用户在手机浏览器内发起支付的场景。如果您的应用是手机H5页面或移动端网站，你可以在 Prompt 中说明："我的页面是手机网页，需要直接在手机上唤起支付宝支付"。
191+
192+
我们会在未来提供更多适合 AI 应用的支付方式，敬请期待。
193+
194+
### 6. 使用协议
195+
196+
本工具是支付宝开放平台能力的组成部分。使用期间，请遵守 [支付宝开放平台开发者服务协议](https://ds.alipay.com/fd-ifz2dlhv/index.html) 及相关商业行为法规。
197+
198+
199+
200+
</appdetail>
201+
202+
203+
204+
205+
206+
207+
208+
## 使用流程
209+
210+
<usedetail id="flushContent">
211+
212+
部署完成拿到 URL 后，准备好支持 SSE 的 MCP Client，通过 SSETransport 进行连接。
213+
214+
</usedetail>
215+
216+
## 二次开发指南
217+
218+
<development id="flushContent">
219+
</development>
220+
221+
222+
223+
224+
225+

‎start-mcp-server-alipay/hook/index.js‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
async function preInit(inputObj) {
2+
}
3+
4+
async function postInit(inputObj) {
5+
6+
}
7+
8+
module.exports = {
9+
postInit,
10+
preInit
11+
}

‎start-mcp-server-alipay/publish.yaml‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Edition: 3.0.0
2+
Type: Project
3+
Name: start-mcp-server-alipay
4+
Version: 0.0.3
5+
Provider:
6+
- 阿里云 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
7+
Description: 支付宝 MCP Server
8+
HomePage: https://github.com/devsapp/fcai-mcp-servers/tree/main/start-mcp-server-alipay
9+
Tags: #标签详情
10+
- MCP
11+
- Node.js
12+
Category: MCP服务 # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
13+
Service: # 使用的服务
14+
函数计算: # 取值内容参考：https://api.devsapp.cn/v3/common/args.html
15+
Authorities: #权限描述
16+
- AliyunFCFullAccess # 所需要的权限，例如AliyunFCFullAccess
17+
Organization: 阿里云函数计算（FC） # 所属组织
18+
Effective: Public # 是否公开，取值：Public，Private，Organization
19+
Parameters:
20+
type: object
21+
additionalProperties: false # 不允许增加其他属性
22+
required: # 必填项
23+
- region
24+
properties:
25+
region:
26+
title: 地域
27+
type: string
28+
default: cn-hangzhou
29+
description: 创建应用所在的地区
30+
enum:
31+
- cn-beijing
32+
- cn-hangzhou
33+
- cn-shanghai
34+
- cn-shenzhen
35+
- ap-southeast-1

‎start-mcp-server-alipay/src/.signore‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
./code/node_modules/
2+
./code/dist

‎start-mcp-server-alipay/src/build.yaml‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
start-mcp-server-alipay:
2+
default:
3+
rootPath: ./
4+
languages:
5+
- nodejs22
6+
cache:
7+
paths:
8+
- "~/.npm"
9+
steps:
10+
- run: npm install @alipay/mcp-server-alipay

‎start-mcp-server-alipay/src/code/.fcignore‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
node_modules
2+
check_node_version.mjs

0 commit comments

Comments
 (0)