mcpField
C
CigalPay

CigalPay

本地服务
cigalpay.com其他0今天更新

关于 CigalPay

CigalPay MCP 服务让 AI 助手通过自然语言管理加密货币收款,适合需要创建支付链接并跟踪付款或退款的商户。支持多种币种结账,并可按需启用退款操作。

主要功能

  1. 01创建美元或欧元支付链接
  2. 02查询付款状态与币种金额
  3. 03按订单编号查找付款
  4. 04列出待付款项与支持币种
  5. 05查询及按需发起退款

适用场景

  1. 01为发票创建加密货币支付链接
  2. 02确认订单款项是否到账
  3. 03查看付款退款进度

MCP 相关

该 MCP 服务向 Claude、Cursor、VS Code 等 MCP 客户端提供支付链接创建、付款查询及退款工具。退款默认关闭,启用后属于需确认的资金操作。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"cigalpay-cigalpay": {
"command": "npx",
"args": [
"-y",
"cigalpay-mcp"
],
"env": {
"CIGALPAY_ACCOUNT_ID": "<CIGALPAY_ACCOUNT_ID>",
"CIGALPAY_API_KEY": "<CIGALPAY_API_KEY>",
"CIGALPAY_NOTIFY_URL": "<CIGALPAY_NOTIFY_URL>",
"CIGALPAY_ALLOW_REFUNDS": "<CIGALPAY_ALLOW_REFUNDS>"
}
}
}
}
启动命令npx -y cigalpay-mcp
需要配置的环境变量
CIGALPAY_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 notifications
CIGALPAY_ALLOW_REFUNDSSet to 1 to enable the create_refund tool

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

安装包
npmcigalpay-mcp1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

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 工作流。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。