coinvoyage-paykit-claudeplugin

Claude Code 插件，用于将 CoinVoyage（一个非托管的多链加密货币支付网关）集成到您使用 Claude 构建的任何应用程序中。

包含两个功能模块：

1. 技能 (coinvoyage-payments) — 当 Claude 协助处理加密货币支付、结账、稳定币或 Web3 支付工作时触发。提供端到端的集成指导：服务端支付订单创建、React PaymentWidget、Webhook 签名验证以及针对非 JS 技术栈的 REST API 后备方案。

2. MCP 服务器 (@kingpeque/coinvoyage-mcp) — 为 Claude 提供 15 种直接调用 CoinVoyage API 的工具：创建支付订单、检查状态、管理 Webhook、获取兑换报价等。

社区维护的集成插件。 与 CoinVoyage 无官方关联。

安装

/plugin install KingPeque/coinvoyage-paykit

安装时系统会提示您输入以下信息：

密钥通过 Claude Code 的敏感配置路径存储在您的系统钥匙串中 — 它永远不会出现在您提交的代码文件中。

Related MCP server: Purple Flea Wallet

您现在可以对 Claude 说什么

安装完成后，以下类型的请求将激活该技能和/或 MCP 工具：

• “为我的 Next.js 结账页面添加加密货币支付功能”

• “我想在我的网站上接受比特币支付”

• “构建一个捐赠页面，支持任何加密货币，并自动结算为 Base 链上的 USDC”

• “创建一个 25 美元的测试发票，并结算到 Base 链上的 USDC，这是我的钱包地址”

• “为已完成的订单在 https://mysite.com/api/webhooks/coinvoyage 注册一个 Webhook”

包含内容

coinvoyage-paykit/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest (prompts user for API keys)
├── mcp.json                     # Declares the bundled MCP server
├── skills/
│   └── coinvoyage-payments/
│       └── SKILL.md             # Integration guide + trigger description
├── mcp-server/                  # Source for @kingpeque/coinvoyage-mcp (npm)
│   ├── src/index.ts
│   ├── package.json
│   └── tsconfig.json
├── README.md
└── LICENSE

支持的链

比特币、Solana、以太坊、Optimism、Arbitrum、Base、BSC、Polygon、Sui — 以及这些链上的任何 ERC-20 / SPL / 原生代币。请参阅 supported_chains MCP 工具中的完整链 ID 参考。

定价（CoinVoyage 的定价，非本插件定价）

• 每笔成功支付收取 1.5% 手续费

• 出金（Offramp）免费

• 商户可以在此基础上额外添加自定义百分比费用

• 本插件免费且采用 MIT 协议开源。关于 CoinVoyage 费率的批量折扣，请联系：help@coinvoyage.io。

安全态势

• 仓库中无密钥。 所有敏感信息均存储在您的 Claude Code 配置中，并在运行时注入到 MCP 服务器。

• 用户专属密钥。 每个开发者使用自己的 CoinVoyage API 密钥。没有任何中心化托管；不存在可被攻破的共享服务器。

• 最小化网络暴露。 MCP 服务器仅与 api.coinvoyage.io（或您配置的覆盖地址）通信。

• HMAC-SHA256 身份验证，用于特权操作（SALE/REFUND/Webhooks/费用申领）。

• 开源。 请阅读 MCP 服务器源码 mcp-server/src/index.ts — 代码量不到 300 行。

本地开发

git clone https://github.com/KingPeque/coinvoyage-paykit
cd coinvoyage-paykit/mcp-server
npm install
npm run build
# Point your MCP client at ./mcp-server/dist/index.js with COINVOYAGE_API_KEY set

通过将 skills/coinvoyage-payments/ 软链接到 ~/.claude/skills/（或以开发模式安装插件）来在本地运行该技能。

贡献

欢迎在 https://github.com/KingPeque/coinvoyage-paykit/issues 提交问题和 PR。请勿提交 API 密钥、机密信息或钱包地址。

许可证

MIT — 详见 LICENSE。

链接

• CoinVoyage 官网: https://coinvoyage.io

• CoinVoyage 文档: https://docs.coinvoyage.io

• 控制台: https://dashboard.coinvoyage.io

• 支持: help@coinvoyage.io

• 本插件的问题反馈: https://github.com/KingPeque/coinvoyage-paykit/issues