mcpField
C
coinvoyage

coinvoyage

ローカル
github.com/KingPeque金融データ028 週間前に更新

coinvoyage について

coinvoyage-paykit-claudepluginは、アプリへのCoinVoyage暗号資産決済の組み込みを支援する、コミュニティ運営のClaude Codeプラグインです。統合ガイドのスキルと、注文やWebhook、スワップ見積もりを扱う15個のAPIツールを備えたMCPサーバーで構成されます。

主な機能

  1. 01サーバー側PayOrder連携を案内
  2. 02React PaymentWidgetとWebhookに対応
  3. 03非JavaScriptスタック向けREST APIの代替手段
  4. 0415個のツールでCoinVoyage APIを呼び出し
  5. 05注文、状態、Webhook、スワップ見積もりを操作

活用シーン

  1. 01アプリのチェックアウトに暗号資産決済を追加
  2. 02決済注文の作成と状態確認
  3. 03Webhookの登録と署名検証
  4. 04Claude Codeからスワップ見積もりを取得

MCP 対応

同梱の@kingpeque/coinvoyage-mcpサーバーは15個のツールを公開し、Claude CodeからCoinVoyage APIを呼び出せます。PayOrderの作成、状態確認、Webhook管理、スワップ見積もりなどに対応し、設定した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.2

ツール

15

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
typeenumいいえPayOrder のタイプ。デフォルトは DEPOSIT です。DEPOSIT | SALE | REFUND
amountobjectはい請求金額。法定通貨(例:USD)またはトークンのシンボルを指定します。
amount.valuenumberはい10 進数の金額(例:19.99)。
amount.currencystringはい例:"USD"、"USDC"、"BTC"
metadataobjectいいえ任意の加盟店メタデータ(orderId、sku、customer など)。
settlementobjectいいえ資金の決済先。例:{ chainId: 8453, token: "USDC" } は Base で USDC を受け取る場合です。
settlement.tokenstringいいえ
settlement.chainIdnumberいいえ
settlement.walletAddressstringいいえ
expiresInSecondsnumberいいえ任意:PayOrder が期限切れになるまで支払い可能な状態を維持する時間。

詳細

coinvoyage-paykit-claudeplugin

CoinVoyage(非カストディアル型のマルチチェーン暗号資産決済ゲートウェイ)を、Claude で開発するあらゆるアプリに統合するための Claude Code プラグインです。

2 つの機能をまとめています。

  1. スキル(coinvoyage-payments) — Claude が暗号資産決済、チェックアウト、ステーブルコイン、Web3 決済に関する作業を支援するときに起動します。サーバーサイドでの PayOrder 作成、React の PaymentWidget、Webhook 署名の検証、JavaScript を使わないスタック向けの REST API フォールバックまで、統合を一貫してガイドします。
  2. MCP サーバー(@kingpeque/coinvoyage-mcp) — CoinVoyage API を直接呼び出す 15 個のツールを Claude に提供します。PayOrder の作成、ステータスの確認、Webhook の管理、スワップ見積もりの取得などを行えます。

コミュニティによって保守されている統合です。 CoinVoyage との公式な提携はありません。

インストール

/plugin install KingPeque/coinvoyage-paykit

インストール時に、次の項目の入力を求められます。

項目必須備考
api_keyはいhttps://dashboard.coinvoyage.io → Developers で取得した公開 API キー
api_secret任意SALE/REFUND 注文、Webhook 管理、手数料の請求に必要です。空欄にすると、Claude は読み取りと DEPOSIT フローのみを実行できます。
api_base_url任意既定値は https://api.coinvoyage.io です。

シークレットは Claude Code の機密設定経路を通じてシステムのキーチェーンに保存されるため、コミットするファイルに書き込まれることはありません。

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

対応チェーン

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 サーバーのソースコードは 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/ にシンボリックリンクするか、開発モードでプラグインをインストールします。

コントリビューション

Issue や PR は https://github.com/KingPeque/coinvoyage-paykit/issues までお寄せください。API キー、シークレット、ウォレットアドレスはコミットしないでください。

ライセンス

MIT — LICENSE を参照してください。

リンク

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。