Univoucher Crypto Gift Cards

UniVoucher MCP 服务

UniVoucher.com 的官方模型上下文协议（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"
      }
    }
  }
}

⚠️ 安全提示：切勿将钱包私钥提交到版本控制系统。请使用环境变量或安全的配置管理方式。

📝 注意：私钥为可选项。你可以提供标准的 Ethereum 加密货币钱包私钥，可带或不带 0x 前缀。

支持的 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"）
• 批量创建：单笔交易最多创建 100 张卡片

示例用法

配置完成后，你可以向 AI 助手提问：

• “向我展示完整的 UniVoucher 开发者集成指南”
• “获取创建礼品卡的完整文档”
• “Ethereum 上当前的费用是多少？”
• “列出所有可用的 UniVoucher 文档页面”
• “向我展示 UniVoucher 工作原理的技术文档”
• “获取 API 参考和安全文档”
• “UniVoucher 协议中有多少种卡？”
• “在 Ethereum 上创建一张新的礼品卡，金额为 0.1 ETH”
• “在 Polygon 上创建一张金额为 100 USDC 的礼品卡”
• “在 Base 上创建 5 张礼品卡，每张金额为 50 USDC”

链接

• 官方网站：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