关于 CigalPay
CigalPay MCP 服务让 AI 助手通过自然语言管理加密货币收款,适合需要创建支付链接并跟踪付款或退款的商户。支持多种币种结账,并可按需启用退款操作。
主要功能
- 01创建美元或欧元支付链接
- 02查询付款状态与币种金额
- 03按订单编号查找付款
- 04列出待付款项与支持币种
- 05查询及按需发起退款
适用场景
- 01为发票创建加密货币支付链接
- 02确认订单款项是否到账
- 03查看付款退款进度
MCP 相关
该 MCP 服务向 Claude、Cursor、VS Code 等 MCP 客户端提供支付链接创建、付款查询及退款工具。退款默认关闭,启用后属于需确认的资金操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y cigalpay-mcpCIGALPAY_ACCOUNT_IDYour Account ID (dashboard > Settings > API credentials)CIGALPAY_API_KEY密钥Your API key (dashboard > Settings > API credentials)CIGALPAY_NOTIFY_URLDefault public HTTPS URL for signed payment notificationsCIGALPAY_ALLOW_REFUNDSSet to 1 to enable the create_refund tool本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
CigalPay MCP 服务
让 Claude、Cursor、VS Code 和其他 AI 助手使用你的 CigalPay 账户:只需用自然语言提问,即可创建加密货币付款链接、检查付款是否到账并跟踪退款。
“为发票 1042(徽标设计)创建一个 49 EUR 的付款链接。” “订单 1042 的付款确认了吗?”
价格以 USD 或 EUR 计价。客户可在 CigalPay 结账页面选择币种(Bitcoin、Tron 上的 USDT、Ethereum、Solana、Litecoin 等),汇率锁定 30 分钟。
工具
| 工具 | 功能 |
|---|---|
create_checkout | 创建以 USD 或 EUR 计价的付款,并返回结账链接(每笔付款最高 5,000)。fee_paid_by: customer 会将手续费加到客户应付金额中 |
get_payment | 查询付款状态、币种和金额。confirmed 或 finished 表示已付款 |
get_payments_by_order | 查询为某个订单引用创建的所有付款 |
list_active_payments | 查询仍在等待客户付款的付款 |
list_supported_coins | 查询可直接接受的币种 |
list_refunds | 查询付款的退款及其状态 |
create_refund | 以加密货币退款。默认关闭:设置 CIGALPAY_ALLOW_REFUNDS=1 |
create_refund 会从你的 CigalPay 余额中转出资金,因此只有在你启用后才可使用,并且该工具标记为具有破坏性,因此助手会在使用前征求确认。
设置
在 CigalPay 控制面板的 Settings → API credentials 中获取你的账户 ID和 API 密钥。需要 Node.js 18 或更高版本。
| 变量 | |
|---|---|
CIGALPAY_ACCOUNT_ID | 创建付款链接所必需 |
CIGALPAY_API_KEY | 读取付款和退款所必需。请妥善保密 |
CIGALPAY_NOTIFY_URL | 用于接收已签名付款通知的公开 HTTPS URL。create_checkout 需要此项,除非你每次都传入 notify_url |
CIGALPAY_RETURN_URL | 客户付款后跳转到的页面(默认:cigalpay.com) |
CIGALPAY_ALLOW_REFUNDS | 设置为 1 以启用 create_refund |
Claude Code
claude mcp add cigalpay \
-e CIGALPAY_ACCOUNT_ID=your-account-id \
-e CIGALPAY_API_KEY=your-api-key \
-e CIGALPAY_NOTIFY_URL=https://your-site.com/cigalpay/notify \
-- npx -y cigalpay-mcp
Claude Desktop、Cursor、VS Code 等
将以下内容添加到客户端的 MCP 配置文件(claude_desktop_config.json、.cursor/mcp.json 等):
{
"mcpServers": {
"cigalpay": {
"command": "npx",
"args": ["-y", "cigalpay-mcp"],
"env": {
"CIGALPAY_ACCOUNT_ID": "your-account-id",
"CIGALPAY_API_KEY": "your-api-key",
"CIGALPAY_NOTIFY_URL": "https://your-site.com/cigalpay/notify"
}
}
}
}
付款通知
付款状态发生变化时,CigalPay 会向你的通知 URL 发送已签名通知。请先使用 JavaScript SDK(CigalPay.verifyWebhook)或 PHP SDK 检查 x-cigalpay-sig 签名,再信任该通知。请参阅开发者文档。
发布
在 package.json、server.json(两处)和 CHANGELOG.md 中更新版本,然后推送 vX.Y.Z 标签。GitHub Actions 会将软件包暂存到 npm;在 npmjs.com 上批准后,再运行 MCP Registry 工作流。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。