Toreador

@toreador/mcp-server

Toreador 的官方 Model Context Protocol 服务。可让 Claude Desktop、Cursor 以及其他支持 MCP 的助手代您生成加密货币二维码并管理支付会话。

⚠️ 需要从 Toreador 控制面板获取 Pro 方案 API 密钥（tdr_...）。MCP 服务在本地运行，并使用您的密钥调用 https://toreador.io/api/v1/public。

提供的工具

工具	功能
toreador_generate_qr	为原生代币（BTC、ETH、SOL、POL）或 Solana SPL（Solana 上的 USDC）生成二维码。返回链上支付 URI 和 base64 PNG 数据 URI。
toreador_create_session	为 Ethereum、Polygon 或 Base 上的 ERC-20 稳定币（USDC、USDT、EURC）创建托管支付会话。返回会话 ID、安全码和托管支付 URL。
toreador_get_payment_status	轮询 ERC-20 支付会话的状态：pending / submitted / confirming / completed / expired / failed。
toreador_list_history	列出最近 50 次二维码生成记录。
toreador_list_sessions	列出最近 50 个 ERC-20 支付会话。

在 Claude Desktop 中安装

编辑 Claude Desktop 的配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

在 mcpServers 下添加 toreador 条目：

{
  "mcpServers": {
    "toreador": {
      "command": "npx",
      "args": ["-y", "@toreador/mcp-server"],
      "env": {
        "TOREADOR_API_KEY": "tdr_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。您应该会在工具菜单中看到 5 个 Toreador 工具。

在 Cursor 中安装

在 Cursor 设置 → MCP →“添加新的 MCP 服务”中，粘贴：

{
  "command": "npx",
  "args": ["-y", "@toreador/mcp-server"],
  "env": { "TOREADOR_API_KEY": "tdr_..." }
}

示例提示词

安装完成后，试着在您的 MCP 客户端中使用以下提示词：

• “为 0.001 BTC 生成一个 Bitcoin 二维码，收款地址为 bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh。”
• “在 Polygon 上创建一个 50 USDC 的 USDC 支付会话，收款地址为 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18。”
• “会话 ses_123 的状态是什么？”
• “显示最近 10 个支付会话。”

助手会选择合适的工具、调用 Toreador 并返回结果—— 包括二维码数据 URI，大多数客户端都能以内嵌形式显示。

配置

环境变量	默认值	说明
TOREADOR_API_KEY	必填	您的 Pro 方案 API 密钥。格式：tdr_...。
TOREADOR_BASE_URL	https://toreador.io/api/v1/public	覆盖 API 基础 URL（适用于测试）。
TOREADOR_TIMEOUT_MS	30000	每个请求的超时时间，单位为毫秒。

信任与安全

• 仅在本地运行。 MCP 服务通过 stdio 在您的计算机上运行。除向 toreador.io 发起 HTTPS 请求外，您的 API 密钥不会离开计算机。
• 非托管式。 Toreador 从不持有资金。MCP 工具只会生成二维码并读取会话状态，无法转移资金。
• 仅读取或创建，不执行破坏性操作。 工具只会生成新的支付对象或读取现有对象。没有“删除”或“退款”工具。

从源代码构建

git clone https://github.com/Bentonabento/toreador-sdk.git
cd toreador-sdk/mcp
npm install
npm run build
TOREADOR_API_KEY=tdr_... node dist/index.js

服务将启动，在 stderr 中输出 [toreador-mcp] ready (5 tools registered)，并等待从 stdin 接收 MCP 请求。

许可证

MIT