buffgift-mcp

BuffGift MCP Server — 让 AI（OpenClaw、Cursor 等）帮你检索礼品卡、创建订单、发起支付。

快速开始

1. 在 BuffGift 个人中心 生成 API Key
2. 配置 MCP 客户端

OpenClaw 配置

在 OpenClaw 的 MCP 配置中添加（如 openclaw.json 或可视化界面）：

{
  "buffgift": {
    "command": "npx",
    "args": ["-y", "buffgift-mcp"],
    "env": {
      "BUFFGIFT_API_URL": "https://v2.buffgift.com",
      "BUFFGIFT_API_KEY": "<你的API_Key>"
    }
  }
}

配置后，对 Claw 说「给我买苹果美区礼品卡 10 美元」，Claw 会：

1. 搜索产品 → 2. 创建订单 → 3. 发起支付 → 4. 推送支付链接给你 → 5. 你点开完成支付 → 6. 收到邮件（含卡密）

Cursor 配置

在 .cursor/mcp.json 中添加上述配置即可。

工具列表

| 工具 | 说明 | |------|------| | buffgift_search_products | 搜索礼品卡（keyword, region, category） | | buffgift_get_product | 获取产品详情与 SKU | | buffgift_create_order | 创建订单 | | buffgift_create_payment | 发起支付，返回 payUrl | | buffgift_payment_status | 查询支付状态 | | buffgift_wallet_balance | 查询钱包余额 |

环境变量

• BUFFGIFT_API_URL：API 地址，默认 https://v2.buffgift.com
• BUFFGIFT_API_KEY：API Key（下单/支付必需）