Circle MCP

Circle CCTP MCP服务器

A. 模型上下文协议（MCP） 实现无缝连接的服务器 仅限美元交易 使用Circle的跨链传输协议（CCTP）v2和Circle Paymaster跨多个区块链。非常适合需要处理USDC转账而无需担心本地gas代币的AI代理。

🌟 圆形供电功能

🔄 跨链USDC转账（CCTP v2）

• 本地USDC：真正的USDC转账，而不是桥接或包装代币
• 支持8个测试网：以太坊、Base、Arbitrum、Avalanche、Sonic、Linea、Worldchain、Unichain Sepolia
• 快速和标准模式：选择您的传输速度
• AI友好：简单的工具需要复杂的跨链操作

⛽ 无天然气USDC交易（Circle Paymaster）

• 用美元支付天然气：交易不需要ETH
• 提供两个版本:

- v0.8（推荐）：EIP-7702智能账户，7个测试网 - v0.7（传统版）：Circle智能账户，仅限Arbitrum Sepolia

• 完美的用户体验：接受者无需支付汽油费即可获得USDC
• 账户抽象：内置现代钱包基础设施

🚀 快速开始

Claude桌面配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "circle-cctp": {
      "command": "npx",
      "args": ["-y", "circle-cctp-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x..."
      }
    }
  }
}

🛠 Circle CCTP工具

核心跨链转移工具

cctp_cross_chain_transfer

使用Circle的本地协议在链之间传输USDC

// Transfer 25 USDC from Ethereum to Base
{
  "name": "cctp_cross_chain_transfer",
  "arguments": {
    "fromChainId": 11155111,    // Ethereum Sepolia
    "toChainId": 84532,         // Base Sepolia
    "recipientAddress": "0x742d35Cc6654B3B5B2F214fB3E6dC8b5b1234567",
    "amount": "25.0",
    "transferType": "fast"      // or "standard"
  }
}

参数：

• fromChainId：源链ID
• toChainId：目标链ID
• amount：美元金额（例如“10.5”）
• recipientAddress：目标地址
• transferType：“快速”或“标准”（可选）

get_usdc_balance_cctp

检查任何支持链上的USDC余额

// Check balance on Arbitrum Sepolia
{
  "name": "get_usdc_balance_cctp",
  "arguments": {
    "chainId": 421614,
    "address": "0x742d35Cc6654B3B5B2F214fB3E6dC8b5b1234567"
  }
}

get_supported_chains_cctp

获取Circle CCTP支持的所有链

返回8个受支持的测试网列表，其中包含链ID和域映射。

get_domain_mappings_cctp

获取CCTP协议的Circle域映射

⛽ Circle出纳员工具

Circle Paymaster支持无天然气USDC交易，用户用USDC而不是本地代币（ETH）支付天然气费用。 有两个版本具有不同的功能：

🆕 Circle Paymaster v0.8（推荐）

EIP-7702智能账户——无气交易的未来

主要特点：

• ✅ EIP-7702技术：您的EOA获得智能合约功能
• ✅ 相同地址：智能帐户使用您现有的EOA地址
• ✅ 支持7个测试网：多链无气交易
• ✅ 更好的性能：优化了气体使用和更快的执行
• ✅ 未来考验：最新Circle技术

支持的网络（v0.8）：

🔒 Circle Paymaster v0.7（传统版）

Circle智能账户-原始实施

主要特点：

• ⚠️ Circle智能账户：独立的智能合约钱包
• ⚠️ 不同地址：智能帐户的地址与EOA不同
• ⚠️ 单链：仅支持Arbitrum Sepolia
• ⚠️ 遗留技术：旧圈子实施
• ⚠️ 复杂设置：需要EIP-4337捆绑器集成

支持的网络（v0.7）：

无气交易工具

paymaster_get_account_address

获取您的Circle智能账户地址以获取资金

// Get EIP-7702 account address (v0.8) - RECOMMENDED
{
  "name": "paymaster_get_account_address",
  "arguments": {
    "chainId": 84532,           // Base Sepolia
    "version": "v0.8"           // Uses your EOA address directly!
  }
}

// Get Circle Smart Account address (v0.7) - LEGACY
{
  "name": "paymaster_get_account_address", 
  "arguments": {
    "chainId": 421614,          // Arbitrum Sepolia only
    "version": "v0.7"           // Creates separate smart contract
  }
}

它返回什么：

• 智能帐户地址
• 当前美元余额
• 资金说明
• 账户类型（EIP-7702与Circle智能账户）

paymaster_check_balance

检查您智能账户中的USDC余额

// Check v0.8 balance (recommended)
{
  "name": "paymaster_check_balance",
  "arguments": {
    "chainId": 84532,           // Any of 7 supported chains
    "version": "v0.8"
  }
}

// Check v0.7 balance (legacy)
{
  "name": "paymaster_check_balance",
  "arguments": {
    "chainId": 421614,          // Arbitrum Sepolia only
    "version": "v0.7"
  }
}

paymaster_send_usdc

发送无汽油USDC转账（收款人支付零汽油）

// Send gaslessly with v0.8 (recommended)
{
  "name": "paymaster_send_usdc",
  "arguments": {
    "chainId": 84532,           // Base Sepolia
    "recipientAddress": "0x8879318091671ba1274e751f8cDEF76bb37eb3eD",
    "amount": "5.0",
    "version": "v0.8"           // EIP-7702 Smart Account
  }
}

// Send gaslessly with v0.7 (legacy)
{
  "name": "paymaster_send_usdc",
  "arguments": {
    "chainId": 421614,          // Arbitrum Sepolia only
    "recipientAddress": "0x8879318091671ba1274e751f8cDEF76bb37eb3eD",
    "amount": "5.0", 
    "version": "v0.7"           // Circle Smart Account + EIP-4337
  }
}

v0.8流量（推荐）：

1. 用户以美元支付天然气（不是ETH）
2. 使用EIP-7702向EOA添加智能合约功能
3. 收款人收到USDC，无需支付任何天然气费用
4. 7个连锁店的完美入职体验

v0.7流量（传统）：

1. 用户签署EIP-2612许可证，以便支付宝使用USDC
2. 通过绑定器创建EIP-4337用户操作
3. Paymaster以ETH支付天然气，扣除等值的USDC
4. 仅适用于Arbitrum Sepolia

paymaster_get_supported_chains

获得Circle Paymaster支持的链

// Get v0.8 supported chains (7 testnets) - RECOMMENDED
{
  "name": "paymaster_get_supported_chains",
  "arguments": {
    "version": "v0.8"
  }
}

// Get v0.7 supported chains (1 testnet) - LEGACY
{
  "name": "paymaster_get_supported_chains",
  "arguments": {
    "version": "v0.7"
  }
}

🌐 支持的网络

CCTP v2跨链传输

Circle Paymaster v0.8（EIP-7702智能账户）- 推荐

Circle Paymaster v0.7（Circle智能账户）- 遗产

💬 自然语言用法

在克劳德桌面

"Transfer 10 USDC from Ethereum Sepolia to Base Sepolia"

"Send 5 USDC gaslessly to 0x123... on Base Sepolia using Circle Paymaster v0.8"

"Send 3 USDC gaslessly to 0x123... on Arbitrum Sepolia using Circle Paymaster v0.7"

"What's my USDC balance on all chains?"

"Get my Circle Smart Account address for Base Sepolia (v0.8)"

"Get my Circle Smart Account address for Arbitrum Sepolia (v0.7)"

"Check if I can send gasless transactions on Base Sepolia"

🔄 Circle CCTP的工作原理

Circle的跨链转账协议支持无桥接的本地USDC转账：

Source Chain          Circle API          Destination Chain
     |                     |                        |
[Burn USDC] ---------> [Attestation] ---------> [Mint USDC]
     |                     |                        |
TokenMessenger         Iris API               MessageTransmitter

流程：

1. 燃烧：通过Token Messenger在源链上销毁USDC
2. 证明：Circle的认证服务在烧伤消息上签名
3. 薄荷：在目的地链上铸造的本地USDC

优点：

• ✅ 实际美元（未包装）
• ✅ 2-5分钟接送
• ✅ 费用低于桥梁
• ✅ Circle的审计合同

⛽ Circle Paymaster的工作原理

Circle Paymaster v0.8（EIP-7702）- 推荐

User EOA              Circle Paymaster v0.8         Blockchain
     |                        |                        |
[Add EIP-7702] ----------> [Enable Smart] --------> [Same Address]
     |                        |                        |
[Send USDC] ------------> [Pay Gas in ETH] --------> [Execute Transaction]
     |                        |                        |
[Pay 0 ETH]  [Receive USDC] --------> [Pay Gas in ETH]
     |                        |                        |
[Send UserOp] ----------> [Bundle & Submit] -----> [Execute Transaction]
     |                        |                        |
[Pay 0 ETH] <------------- [Deduct USDC] <--------- [Transaction Success]

v0.7过程：

1. EIP-2612许可证：用户签署支付宝使用USDC的许可
2. 用户操作：通过EIP-4337与支付主数据捆绑的交易
3. 打包机：使用外部绑定器服务（Pimlico）执行
4. 天然气付款：支付宝支付ETH gas，扣除等值的USDC

🚀 入门指南

1.为您的账户充值

对于CCTP传输：

• 在任何受支持的链上使用USDC为EOA提供资金
• 使用 圆形水龙头

对于Circle Paymaster v0.8（推荐）：

# Your EOA and Smart Account are the same address!
"Get my Circle Smart Account address for Base Sepolia using v0.8"
# Fund your EOA address directly at https://faucet.circle.com

对于Circle Paymaster v0.7（传统版）：

# Smart Account has different address than EOA
"Get my Circle Smart Account address for Arbitrum Sepolia using v0.7"
# Fund the returned Smart Account address at https://faucet.circle.com

2.开始转账

# Cross-chain transfer
"Send 10 USDC from Base to Arbitrum"

# Gasless transfer with v0.8 (recommended)
"Send 5 USDC gaslessly to 0x123... on Base using v0.8 paymaster"

# Gasless transfer with v0.7 (legacy)
"Send 5 USDC gaslessly to 0x123... on Arbitrum using v0.7 paymaster"

🔍 出纳员版本比较

💡 最佳实践

1. 使用v0.8支付宝：更好的性能、更多的链和面向未来
2. 仅在以下情况下使用v0.7：您特别需要传统兼容性
3. 基金正确地址:

- v0.8：直接为EOA地址充值 - v0.7：为单独的智能账户地址提供资金

1. 检查版本支持：确保链支持您选择的支付宝版本
2. 测试优先：使用测试网熟悉工具

🛡️ 安全

• 私钥存储在本地 .env 文件
• 所有使用viem在本地签名的交易
• Circle经审计的智能合约
• 用于安全实验的测试网环境

🔗 资源

• Circle CCTP文档
• Circle Paymaster v0.8文档
• Circle Paymaster v0.7文档
• EIP-7702规范
• Circle开发者中心
• 模型上下文协议
• USDC水龙头

📝 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。