@toreador/mcp-server

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

⚠️ 需要来自您的 Toreador 仪表板 的 Pro 计划 API 密钥 (tdr_...)。MCP 服务器在本地运行，并使用您的密钥调用 https://toreador.io/api/v1/public。

公开的工具

在 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 → “Add new MCP server” 中，粘贴：

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

示例提示词

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

• “Generate a Bitcoin QR code for 0.001 BTC to bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh.”

• “Create a USDC payment session for 50 USDC on Polygon to 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18.”

• “What's the status of session ses_123?”

• “Show me my last 10 payment sessions.”

助手将选择正确的工具，调用 Toreador，并返回结果——包括大多数客户端可以内联渲染的二维码数据 URI。

配置

信任与安全

• 仅限本地。 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