giftcardshop

Name: giftcardshop
Author: giftcardshop.org

本地服务

github.com/i2dor商业与营销019 周前更新

代码仓库

关于 giftcardshop

giftcardshop 是供 AI Agent 浏览礼品卡目录并通过 Lightning 下单的 MCP 服务。浏览无需凭据；结账需要共享密钥，返回支付发票，之后可获取单次查看的卡码链接。

主要功能

01浏览礼品卡品牌和商品
02查看商品规格与面额
03创建订单并生成 Lightning 发票
04查询支付状态和卡码揭示状态

适用场景

01在目录中查找礼品卡
02购买前查看可选面额
03通过 Lightning 支付礼品卡订单
04确认订单卡码链接是否可用

MCP 相关

向 MCP 客户端提供目录、商品、订单状态和创建订单工具。读取工具无需密钥；`create_order` 需要 `GCS_INTERNAL_SECRET`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "org-giftcardshop": {
      "command": "npx",
      "args": [
        "-y",
        "@giftcardshop/mcp"
      ],
      "env": {
        "GCS_INTERNAL_SECRET": "<GCS_INTERNAL_SECRET>",
        "GCS_API_BASE": "<GCS_API_BASE>"
      }
    }
  }
}

启动命令npx -y @giftcardshop/mcp

需要配置的环境变量

GCS_INTERNAL_SECRET密钥64-hex HMAC secret that enables create_order (Lightning checkout). Browsing tools work without it. Requested at https://giftcardshop.org/contact.

GCS_API_BASEOverride the public API base. Defaults to https://api.giftcardshop.org.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@giftcardshop/mcp0.1.1stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
limit	integer	否
offset	integer	否
country	string	否	ISO 3166-1 alpha-2 国家/地区代码，例如 US

详细介绍

@giftcardshop/mcp

MCP 服务，可让 AI Agent 浏览 giftcardshop 商品目录，并使用 Lightning 购买礼品卡——无需账户，无需注册。Agent 支付 Lightning 发票后，会收到一个仅可查看一次的揭示链接，其中包含卡码。

读取工具可通过无需密钥的实时公共 API 工作。create_order 处于早期访问阶段：需要共享的 GCS_INTERNAL_SECRET（请通过 https://giftcardshop.org/contact 申请）；如果没有该密钥，读取工具仍可使用，而 create_order 会提示尚未配置。

工具

工具	类型	对接接口
`list_brands`	读取	`GET /v1/brands`
`search_products`	读取	`GET /v1/products`
`get_product`	读取	`GET /v1/products/:id`（变体 + 面额）
`get_order_status`	读取	`GET /v1/orders/:id`（支付状态 + 揭示链接可用性）
`create_order`	写入	`POST /internal/agent-orders`（HMAC）-> Lightning 发票

读取工具会原样传递 API JSON。create_order 返回 { orderId, invoiceId, invoiceUrl, bolt11?, sats?, total, currency, expiresAt }。

运行

# read-only (browsing works, create_order reports "not configured")
npx @giftcardshop/mcp

# with checkout enabled
GCS_INTERNAL_SECRET=<64-hex> npx @giftcardshop/mcp

Claude Desktop / 任何 MCP 客户端（stdio）：

{
  "mcpServers": {
    "giftcardshop": {
      "command": "npx",
      "args": ["-y", "@giftcardshop/mcp"],
      "env": { "GCS_INTERNAL_SECRET": "<64-hex>" }
    }
  }
}

配置

环境变量	默认值	用途
`GCS_API_BASE`	`https://api.giftcardshop.org`	公共 API 基础地址
`GCS_INTERNAL_SECRET`	（未设置）	64 位十六进制 HMAC 密钥；启用 `create_order`。未设置 = 只读。

结账（create_order）

create_order 会向 POST /internal/agent-orders 发送 POST 请求，使用 GCS_INTERNAL_SECRET 进行 HMAC 签名（请求头 x-internal-sig），并返回 Lightning 发票。支付后，轮询 get_order_status 获取仅可查看一次的揭示链接。无需 Nostr 身份，也无需合作伙伴账户。