Univoucher Crypto Gift Cards

UniVoucher MCP サーバー

UniVoucher.com の公式 Model Context Protocol（MCP）サーバー - 複数のブロックチェーン上で暗号資産ギフトカードを作成、利用できる、世界初の分散型暗号資産ギフトカードプロトコルです。

UniVoucher とは？

UniVoucher は、Ethereum、Polygon、BSC など複数のブロックチェーン上で暗号資産ギフトカードを作成、利用できる、世界初の分散型実物暗号資産ギフトカードプロトコルです。

🚀 クイックインストール

注：手動インストールは不要です。以下の設定を MCP クライアントに追加するだけで、必要に応じて自動的にダウンロードされ、実行されます。

MCP の設定

MCP の設定ファイル（mcp.json など）に、以下を追加します。

基本設定（読み取り専用アクセス）

{
  "mcpServers": {
    "univoucher": {
      "command": "npx",
      "args": ["-y", "univoucher-mcp@latest"],
      "env": {}
    }
  }
}

ウォレットの秘密鍵を使用する場合（カード作成を含むフルアクセス）

{
  "mcpServers": {
    "univoucher": {
      "command": "npx",
      "args": ["-y", "univoucher-mcp@latest"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_ethereum_wallet_private_key_here"
      }
    }
  }
}

⚠️ セキュリティに関する注意：ウォレットの秘密鍵をバージョン管理にコミットしないでください。環境変数または安全な設定管理を使用してください。

📝 注：秘密鍵は任意です。0x プレフィックスの有無を問わず、標準的な Ethereum 暗号資産ウォレットの秘密鍵を指定できます。

対応 MCP クライアント

• Cursor：Cursor の MCP 設定に追加します
• Claude Desktop：Claude Desktop の設定に追加します
• MCP 互換クライアント：上記の設定を使用します

代替インストール方法

グローバルインストール

npm install -g univoucher-mcp@latest

特定バージョンのインストール

npm install [email protected]

その後、MCP の設定で univoucher-mcp を直接使用します。

機能

📚 ドキュメントへのアクセス

• UniVoucher のドキュメントページをすべて、完全な内容で取得できます
• 利用可能なドキュメントを一覧表示して、閲覧できます
• 関連する複数のページをまとめて取得し、包括的な情報を確認できます
• 検索結果を推測する必要はありません。必要なページを正確に取得できます

📊 ライブ API へのアクセス

• 高度なフィルタリングでギフトカードを検索できます
• 対応するすべてのチェーンの現在の手数料を取得できます
• 対応するブロックチェーンネットワークを確認できます
• プロトコルのリアルタイム統計を取得できます

🛠️ 利用可能なツール

ツール	説明
list_doc_pages	利用可能なドキュメントページを説明付きで一覧表示します
get_doc_page	指定したドキュメントページの内容をすべて取得します
get_multiple_doc_pages	複数のドキュメントページの内容をまとめて取得します
query_api_cards	プロトコルからギフトカードを検索します
get_single_card	指定したカードの詳細を取得します
create_gift_card	新しいギフトカードを作成します（秘密鍵が必要です）
get_current_fees	現在のプロトコル手数料を取得します
get_chains	対応するブロックチェーンネットワークを取得します
get_fee_history	過去の手数料データを取得します

カード作成機能

前提条件

• ウォレットの秘密鍵：標準的な Ethereum 暗号資産ウォレットの秘密鍵（0x プレフィックスの有無を問わず指定できます。省略可能です）
• 対応ネットワーク：Ethereum（1）、Base（8453）、BNB Chain（56）、Polygon（137）、Arbitrum（42161）、Optimism（10）、Avalanche（43114）
• トークン対応：任意の ERC-20 トークンまたはネイティブ通貨

セキュリティ

• ウォレットの秘密鍵はローカルでのみ使用され、保存されることはありません
• セキュリティ確保のため、鍵は環境変数を介して渡されます
• すべてのトランザクションはローカルで署名され、UniVoucher API に送信されます
• 秘密鍵は任意です。秘密鍵を指定せずに、MCP サーバーを読み取り専用操作に使用できます
• ダイレクトレスポンスモードを使用するため、コールバックなしでカードの詳細をすぐに取得できます

対応トークン

• ネイティブ通貨：トークンアドレスとして 0x0000000000000000000000000000000000000000 を使用します
• ERC-20 トークン：トークンのコントラクトアドレスを使用します
• 金額の形式：大きな数値には文字列形式を使用します（例：1 ETH の場合は "1000000000000000000"）
• 一括作成：1 回のトランザクションで最大 100 枚のカードを作成できます

使用例

設定が完了したら、AI アシスタントに次のように依頼できます。

• 「開発者向けの UniVoucher 統合ガイドをすべて表示してください」
• 「ギフトカードの作成に関するドキュメントをすべて取得してください」
• 「Ethereum の現在の手数料はいくらですか？」
• 「利用可能な UniVoucher ドキュメントのページをすべて一覧表示してください」
• 「UniVoucher の仕組みに関する技術ドキュメントを表示してください」
• 「API リファレンスとセキュリティドキュメントを取得してください」
• 「UniVoucher プロトコルにはカードがいくつありますか？」
• 「Ethereum で 0.1 ETH のギフトカードを新規作成してください」
• 「Polygon で 100 USDC のギフトカードを作成してください」
• 「Base でそれぞれ 50 USDC のギフトカードを 5 枚作成してください」

リンク

• 公式ウェブサイト：univoucher.com
• ドキュメント：docs.univoucher.com
• API：api.univoucher.com
• GitHub：UniVoucher MCP リポジトリ
• NPM パッケージ：univoucher-mcp

サポート

• GitHub Issues：バグの報告や機能のリクエスト
• Telegram：UniVoucher コミュニティ
• メール：[email protected]

ライセンス

Business Source License 1.1 - 詳細は LICENSE ファイルをご覧ください

このプロジェクトは 2035-05-04 に MIT License へ移行します

---

UniVoucher エコシステムのために ❤️ を込めて開発 | UniVoucher.com にアクセス