Free USDC Transfer MCP Server 使用说明

项目简介

Free USDC Transfer MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为用户提供免费的 USDC 转账服务。它利用 Coinbase CDP MPC 钱包技术，让用户能够在 Base 区块链上便捷、无手续费地进行 USDC 转移，并支持 ENS 和 BaseName 域名解析，简化了转账地址的输入。

主要功能点

免费USDC转账: 在 Base 区块链上向任何地址或 ENS/BaseName 域名免费发送 USDC。
Coinbase MPC 钱包集成: 创建和管理 Coinbase MPC 钱包，安全便捷地进行交易。
域名解析: 自动支持 ENS 和 BaseName 域名，无需手动查找链上地址。
工具函数:
- 'tranfer-usdc': 将指定数量的 USDC 转账给指定接收者，支持链上地址和域名。
- 'create_coinbase_mpc_wallet': 创建一个新的 Coinbase MPC 钱包地址。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node Package Manager)。
使用 npx 运行: 无需手动下载和安装仓库代码，可以直接使用 'npx' 命令运行该 MCP 服务器。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 Free USDC Transfer MCP Server，您需要在客户端的配置文件中添加以下服务器配置信息。

以 'claude_desktop_config.json' 为例:

{
  "mcpServers": {
    "free-usdc-transfer": {
      "command": "npx",
      "args": [
        "-y",
        "@magnetai/free-usdc-transfer"
      ],
      "env": {
        "COINBASE_CDP_API_KEY_NAME": "YOUR_COINBASE_CDP_API_KEY_NAME",  // 替换为您的 Coinbase CDP API Key Name
        "COINBASE_CDP_PRIVATE_KEY": "YOUR_COINBASE_CDP_PRIVATE_KEY"    // 替换为您的 Coinbase CDP Private Key
      }
    }
  }
}

配置参数说明:

'"server name"': 'free-usdc-transfer'，服务器名称，客户端用此名称标识和调用该服务器。
'"command"': 'npx'，用于执行 npm 包的命令。
'"args"': '["-y", "@magnetai/free-usdc-transfer"]'，'npx' 命令的参数，用于运行 '@magnetai/free-usdc-transfer' npm 包。 '-y' 参数表示自动确认安装包。
'"env"': 环境变量配置，用于服务器运行时读取必要的 API 密钥和私钥。
- '"COINBASE_CDP_API_KEY_NAME"': 必需配置。您的 Coinbase CDP API Key Name。您需要在 Coinbase CDP 开发者仪表板创建并获取。
- '"COINBASE_CDP_PRIVATE_KEY"': 必需配置。您的 Coinbase CDP Private Key。同样需要在 Coinbase CDP 开发者仪表板生成。

重要提示:

请务必将 'YOUR_COINBASE_CDP_API_KEY_NAME' 和 'YOUR_COINBASE_CDP_PRIVATE_KEY' 替换为您在 Coinbase CDP 平台申请到的真实密钥信息。
建议将 API 密钥和私钥作为环境变量安全地配置，避免硬编码在配置文件中。

基本使用方法

启动 MCP 服务器: MCP 客户端（如 Claude Desktop）在配置 'free-usdc-transfer' 服务器后，会自动根据配置启动该服务器。您无需手动启动。
通过 MCP 客户端调用工具: 在 MCP 客户端中，您可以调用以下工具来使用 Free USDC Transfer MCP Server 的功能：
- 'create_coinbase_mpc_wallet': 调用此工具将创建一个新的 Coinbase MPC 钱包地址。首次使用转账功能前，您需要先调用此工具创建钱包，并将 USDC 存入该钱包。
- 'tranfer-usdc': 调用此工具进行 USDC 转账。您需要提供以下参数：
  - 'usdc_amount' (number): 要转账的 USDC 数量，必须大于 0。
  - 'recipient' (string): 接收者的链上地址或 ENS/BaseName 域名。

示例对话 (在支持 MCP 工具调用的 LLM 应用中):

用户: 创建我的 USDC 钱包 LLM: (调用 'create_coinbase_mpc_wallet' 工具) 您的 Coinbase MPC 钱包地址已成功创建 (地址: xxx)。请先向该钱包地址存入 USDC，之后即可使用免费转账功能。

用户: 转账 10 USDC 给 example.eth LLM: (调用 'tranfer-usdc' 工具, 参数: 'usdc_amount: 10', 'recipient: "example.eth"') 交易 (发送 10 USDC 给 0x...) 已在 Base 链上安排。您可以通过以下链接查看交易详情: [BaseScan 链接]

注意:

由于区块链交易的确认时间不确定，'tranfer-usdc' 工具仅会安排转账，不会等待交易完成。您需要通过提供的 BaseScan 链接查看交易状态。
首次使用转账功能前，请确保已创建 Coinbase MPC 钱包并存入 USDC。

通过以上步骤，您就可以在支持 MCP 协议的客户端中使用 Free USDC Transfer MCP Server 提供的免费 USDC 转账功能了。

关键词