coinvoyage

Name: coinvoyage
Author: KingPeque

本地服务

github.com/KingPeque金融数据028 周前更新

代码仓库

关于 coinvoyage

coinvoyage-paykit-claudeplugin 是由社区维护的 Claude Code 插件，用于将 CoinVoyage 加密货币支付集成到应用中。它结合集成技能与 MCP 服务，提供 15 个 API 工具，用于支付订单、Webhook 和兑换报价等操作。

主要功能

01指导服务端 PayOrder 集成
02支持 React PaymentWidget 和 Webhook
03为非 JS 技术栈提供 REST API 备用方案
04通过 15 个工具调用 CoinVoyage API
05处理订单、状态、Webhook 和兑换报价

适用场景

01为应用结账流程添加加密货币支付
02创建并查询支付订单
03注册 Webhook 并验证签名
04通过 Claude Code 获取兑换报价

MCP 相关

随附的 @kingpeque/coinvoyage-mcp 服务暴露 15 个工具，让 Claude Code 调用 CoinVoyage API，包括创建 PayOrder、查询状态、管理 Webhook 和获取兑换报价。访问使用配置的 CoinVoyage API 密钥；特权操作还需要 API 密钥 secret。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "kingpeque-coinvoyage": {
      "command": "npx",
      "args": [
        "-y",
        "@kingpeque/coinvoyage-mcp"
      ],
      "env": {
        "COINVOYAGE_API_KEY": "<COINVOYAGE_API_KEY>",
        "COINVOYAGE_API_SECRET": "<COINVOYAGE_API_SECRET>",
        "COINVOYAGE_API_BASE_URL": "<COINVOYAGE_API_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @kingpeque/coinvoyage-mcp

需要配置的环境变量

COINVOYAGE_API_KEY密钥Your CoinVoyage public API key. Get one at https://dashboard.coinvoyage.io (Developers section).

COINVOYAGE_API_SECRET密钥Server-side API secret. Required for SALE/REFUND PayOrders, fee claims, and webhook management. Leave unset if you only need DEPOSIT (merchant invoice) flows.

COINVOYAGE_API_BASE_URLOverride the API base URL. Defaults to https://api.coinvoyage.io.

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

安装包

npm@kingpeque/coinvoyage-mcp0.1.2stdio

工具

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

参数	类型	必填	说明
type	enum	否	PayOrder 类型。默认为 DEPOSIT。DEPOSIT \| SALE \| REFUND
amount	object	是	发票金额。使用法定货币（例如 USD）或代币符号。
amount.value	number	是	十进制金额（例如 19.99）。
amount.currency	string	是	例如 "USD"、"USDC"、"BTC"
metadata	object	否	任意的商家元数据（orderId、sku、customer 等）。
settlement	object	否	资金结算至何处。例如：{ chainId: 8453, token: "USDC" }，表示在 Base 上接收 USDC。
settlement.token	string	否
settlement.chainId	number	否
settlement.walletAddress	string	否
expiresInSeconds	number	否	可选：PayOrder 过期前保持可支付状态的时长。

详细介绍

coinvoyage-paykit-claudeplugin

用于集成 CoinVoyage 的 Claude Code 插件。CoinVoyage 是一个非托管、多链加密货币支付网关，可用于你通过 Claude 构建的任何应用。

包含两个部分：

Skill（coinvoyage-payments） — 每当 Claude 协助处理加密货币支付、结账、稳定币或 Web3 支付相关工作时触发。引导你完成端到端集成：服务端创建 PayOrder、React PaymentWidget、Webhook 签名验证，以及供非 JS 技术栈使用的 REST API 备用方案。
MCP 服务（@kingpeque/coinvoyage-mcp） — 为 Claude 提供 15 个工具，可直接调用 CoinVoyage API：创建 PayOrder、查看状态、管理 Webhook、获取兑换报价等。

由社区维护的集成。 与 CoinVoyage 没有官方关联。

安装

/plugin install KingPeque/coinvoyage-paykit

安装时会提示你填写：

字段	必填	说明
`api_key`	是	你的公开 API 密钥，可在 https://dashboard.coinvoyage.io → Developers 中获取
`api_secret`	否	创建 SALE/REFUND 订单、管理 Webhook 和领取费用时需要。留空则 Claude 只能执行读取和 DEPOSIT 流程。
`api_base_url`	否	默认为 `https://api.coinvoyage.io`

密钥通过 Claude Code 的敏感配置机制存储在系统钥匙串中，不会写入你可能提交的文件。

现在可以对 Claude 说什么

安装后，以下类型的请求会触发 Skill 和/或 MCP 工具：

“为我的 Next.js 结账流程添加加密货币支付”
“我想让网站接受 Bitcoin 支付”
“创建一个捐赠页面，接受任意加密货币，同时将结算币种设为 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

支持的链

Bitcoin、Solana、Ethereum、Optimism、Arbitrum、Base、BSC、Polygon、Sui，以及这些链上的任意 ERC-20 / SPL / 原生代币。完整的链 ID 参考请查看 supported_chains MCP 工具。

定价（CoinVoyage 的定价，不是此插件的定价）

每笔成功支付收取 1.5%
出金费率为 0%
商户可以额外收取自定义比例的费用
此插件免费，采用 MIT 许可证。CoinVoyage 费用的批量折扣请联系：[email protected]。

安全状况

此仓库中不含任何密钥。 所有敏感信息都保存在 Claude Code 配置中，并在运行时注入 MCP 服务。
每位用户使用自己的密钥。 每位开发者都使用自己的 CoinVoyage API 密钥。没有集中托管，也没有可被攻破的共享服务。
最小化网络访问范围。 MCP 服务只会连接 api.coinvoyage.io（或你配置的覆盖地址）。
HMAC-SHA256 用于特权操作的身份验证（SALE/REFUND/Webhook/费用领取）。
开源。 可在 mcp-server/src/index.ts 查看 MCP 服务源码，代码不到 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/（或以开发模式安装插件），即可在本地运行 Skill。