关于 cloudpayments-mcp
cloudpayments-mcp 将 CloudPayments 支付 API 暴露给 MCP 客户端,供需要处理支付和订阅的业务及开发团队使用。除扣款、退款外,还涵盖两阶段支付、订单和交易查询。
主要功能
- 01执行即时扣款和预授权
- 02确认或撤销已授权支付
- 03按交易查询并办理退款
- 04创建、更新和取消订阅
- 05创建付款订单并列出交易
适用场景
- 01收取一次性付款并查询交易
- 02完成授权支付的确认或撤销
- 03为用户建立定期订阅
- 04创建付款链接并处理退款
MCP 相关
该 MCP 服务提供 CloudPayments 的支付、退款、订阅、订单和交易工具。支持通过 stdio 或 HTTP 传输连接 MCP 客户端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
🗄 仓库已归档
开发工作已迁移至 theYahia/WWmcp——一个面向非西方 API 的 MCP 服务单体仓库,涵盖独联体、MENA、非洲、LATAM 和东南亚。采用通用核心
@theyahia/mcp-core、统一 CI 和统一发布流程。此处内容的最新版本位于:
servers/cloudpayments/npm 包仍为原来的版本——
@theyahia/cloudpayments-mcp,安装和运行方式与之前相同。 此处不再更新。请在 WWmcp 中提交问题和 pull request。**已归档——开发工作已迁移至 theYahia/WWmcp,**这是一个面向非西方 API 的 MCP 服务单体仓库。 此软件包的当前版本现位于
servers/cloudpayments/。 npm 包@theyahia/cloudpayments-mcp保持不变。 请在那里提交问题和 pull request。
@theyahia/cloudpayments-mcp
用于 CloudPayments API 的 MCP 服务——一步和两步支付、退款、订阅、订单(发票链接)、交易历史记录。12 个工具。
由 @theYahia 开发,属于 Russian API MCP 系列。
快速开始
Claude Desktop
{
"mcpServers": {
"cloudpayments": {
"command": "npx",
"args": ["-y", "@theyahia/cloudpayments-mcp"],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
"CLOUDPAYMENTS_API_SECRET": "your-api-secret"
}
}
}
}
Claude Code
claude mcp add cloudpayments -e CLOUDPAYMENTS_PUBLIC_ID=your-id -e CLOUDPAYMENTS_API_SECRET=your-secret -- npx -y @theyahia/cloudpayments-mcp
Cursor / Windsurf
{
"cloudpayments": {
"command": "npx",
"args": ["-y", "@theyahia/cloudpayments-mcp"],
"env": {
"CLOUDPAYMENTS_PUBLIC_ID": "your-public-id",
"CLOUDPAYMENTS_API_SECRET": "your-api-secret"
}
}
}
HTTP 传输
HTTP_PORT=3000 npx @theyahia/cloudpayments-mcp
# or
npx @theyahia/cloudpayments-mcp --http 3000
端点:POST /mcp(JSON-RPC)、GET /health(状态)。
身份验证
| 变量 | 必需 | 说明 |
|---|---|---|
CLOUDPAYMENTS_PUBLIC_ID | 是 | Public ID(HTTP Basic 用户名) |
CLOUDPAYMENTS_API_SECRET | 是 | API 密钥(HTTP Basic 密码) |
测试时,请使用 CloudPayments 测试终端。
工具(12 个)
支付(5 个)
| 工具 | API 端点 | 说明 |
|---|---|---|
charge_payment | POST /payments/charge | 一步支付(立即扣款) |
auth_payment | POST /payments/auth | 两步支付(授权/预扣) |
confirm_payment | POST /payments/confirm | 确认已授权的支付(全额或部分) |
void_payment | POST /payments/void | 撤销已授权的支付(释放预扣款) |
get_transaction | POST /payments/find | 按 ID 查找交易 |
退款(1 个)
| 工具 | API 端点 | 说明 |
|---|---|---|
refund_payment | POST /payments/refund | 按交易 ID 全额或部分退款 |
订阅(4 个)
| 工具 | API 端点 | 说明 |
|---|---|---|
create_subscription | POST /subscriptions/create | 使用令牌创建定期订阅 |
update_subscription | POST /subscriptions/update | 更新金额、间隔和周期 |
cancel_subscription | POST /subscriptions/cancel | 取消有效订阅 |
list_subscriptions | POST /subscriptions/find | 列出某个用户的订阅 |
订单(1 个)
| 工具 | API 端点 | 说明 |
|---|---|---|
create_order | POST /orders/create | 创建支付订单(发票链接) |
交易(1 个)
| 工具 | API 端点 | 说明 |
|---|---|---|
list_transactions | POST /payments/list | 列出指定日期的所有交易 |
演示提示词
Charge 5000 RUB from the card cryptogram, IP 192.168.1.1, description "Premium plan"
Create a monthly subscription for 999 RUB using token from the last payment, starting May 1st
Show me all transactions for yesterday and refund 2500 RUB on transaction 123456
俄罗斯 API MCP 系列的一部分
| MCP | 状态 | 描述 |
|---|---|---|
| @metarebalance/dadata-mcp | 就绪 | 地址、公司、银行、电话 |
| @theyahia/cbr-mcp | 就绪 | 汇率、基准利率 |
| @theyahia/yookassa-mcp | 就绪 | 支付、退款、收据、付款、webhook |
| @theyahia/cloudpayments-mcp | 就绪 | 支付、订阅、订单 |
| ... | +46 个服务 -- 完整列表 |
许可证
MIT
Telegram:@vhodvai
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。