bridgekitty

BridgeKitty 🐱

面向 AI Agent 的跨链桥聚合 MCP 服务。一个服务，支持 5 种桥接后端，为 EVM、Solana 和 Cosmos 链提供最佳路由。

BridgeKitty 让 AI Agent（Claude、Cursor、GPT 或任何兼容 MCP 的 AI）能够查找并执行跨链桥接转账，并自动优化路由、比较费用、检查余额和发出安全警告。

最新 npm 版本： @persistenceone/[email protected]

v0.3.9 更新内容

• 提取 XPRT 工具 — 质押、奖励和 Farming 工具已移至独立的 xprt-farming-toolkit 软件包
• 移除 Persistence Interop 后端 — BridgeKitty 现已专注于聚合 5 种桥接后端（deBridge、Relay、LI.FI、Across、Squid）
• 精简功能范围 — 工具更少，Agent 的职责范围更明确

v0.3.0 更新内容

• sign_and_send 参数 — Agent 现在可以使用本地存储的钱包密钥直接签名并广播交易
• 完整的 EVM 签名支持 — 适用于所有 EVM 后端（Across、Relay、LI.FI、Squid、deBridge）以及 Persistence Interop（EIP-712）
• 修复模拟问题 — ERC20 桥接现在可用于新钱包（此前会被过早模拟拦截）
• Solana 签名 — 将在下个版本推出

v0.2.0 更新内容

• 支持 Solana — 支持 EVM ↔ Solana 双向桥接（交付原生 SOL，而非包装代币）
• 支持 Cosmos — 通过 Squid（Axelar）支持 EVM → Persistence/Cosmos Hub
• 协议费用透明化 — 每份报价均显示 deBridge fixFee、运营费用和总成本
• 余额警告 — 当钱包余额不足以支付桥接金额、协议费用和 Gas 时发出警告
• XPRT 质押 — 可直接通过 MCP 服务进行质押、取消质押和领取奖励
• Farming 倍数 — 根据奖励 API 跟踪你的质押等级（1x → 3x → 5x）
• 报价自动刷新 — 执行时自动重新获取已过期的报价（60 秒后过期）
• ERC-20 授权 — 始终为代币桥接生成授权（Relay + deBridge）
• 桥接状态跟踪 — 当提供商 API 尚未建立索引时，使用链上回退方案

支持的桥接服务

后端	类型	链	优势
deBridge (DLN)	直接	EVM + Solana	基于意图的快速成交，支持 Solana
Relay	直接	EVM + Solana	无协议费用，Gas 优化
LI.FI	聚合器	EVM	覆盖范围最广（30 多种桥接服务，任意链间兑换）
Across	直接	EVM	成交速度最快（约 6 秒），支持同代币桥接
Squid (Axelar)	聚合器	EVM + Cosmos	EVM → Cosmos 路由的唯一选择

桥接方向

方向	后端	状态
EVM → EVM	全部 5 种	✅ 已用于生产环境
EVM → Solana	deBridge、Relay	✅ 已用于生产环境
Solana → EVM	deBridge	✅ 已用于生产环境
EVM → Cosmos	Squid	✅ 已用于生产环境

快速开始

npx（无需安装）

npx @persistenceone/bridgekitty

Claude Code

将以下内容添加到 MCP 配置中（~/.claude/claude_code_config.json）：

{
  "mcpServers": {
    "bridgekitty": {
      "command": "npx",
      "args": ["@persistenceone/bridgekitty"]
    }
  }
}

Cursor IDE

添加到 Cursor 的 MCP 设置中（Settings > MCP Servers）：

{
  "bridgekitty": {
    "command": "npx",
    "args": ["@persistenceone/bridgekitty"]
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "bridgekitty": {
      "command": "npx",
      "args": ["@persistenceone/bridgekitty"]
    }
  }
}

钱包设置

BridgeKitty 可以管理钱包以执行自主桥接。运行 wallet_setup 为 EVM、Cosmos 和 Solana 创建钱包，也可以在报价中提供自己的地址。

钱包配置存储在 ~/.bridgekitty/.env 中（或你运行程序所在的目录）。密钥不会离开本地设备。

变量	说明
PRIVATE_KEY	EVM 私钥（十六进制）
MNEMONIC	BIP-39 助记词（派生 EVM、Cosmos 和 Solana 密钥）
SOLANA_PRIVATE_KEY	Solana 私钥（base58）

交易签名

默认情况下，bridge_execute 会返回未签名的交易，供 Agent 或用户在外部签名。

设置 sign_and_send: true 可启用自动签名 — BridgeKitty 将使用存储在 ~/.bridgekitty/.env 中的钱包密钥处理完整流程：

1. 授权 — 发送 ERC-20 授权交易（如有需要）
2. 重新构建 — 使用更新后的 nonce 重新获取跨链交易（如果已发送授权交易）
3. 模拟 — 执行 eth_estimateGas 预检
4. 签名 — 使用本地私钥签署交易
5. 广播 — 将交易提交到链上，并返回交易哈希和区块浏览器链接

可选 API 密钥

变量	说明
LIFI_API_KEY	LI.FI API 密钥（更高的速率限制）
DEBRIDGE_API_KEY	deBridge API 密钥
SQUID_INTEGRATOR_ID	Squid 集成商 ID

MCP 工具

核心跨链工具

工具	说明
bridge_get_quote	获取所有后端提供的有竞争力的报价。显示费用、预计耗时和余额警告。
bridge_execute	根据报价构建交易。处理授权，并自动刷新过期报价。设置 sign_and_send: true 可自动签名并广播。
bridge_status	跟踪跨链进度。如果 API 尚未索引，则回退到链上查询。
bridge_chains	列出支持的链及其提供方覆盖情况。
bridge_tokens	搜索某条链上的代币。

多跳与发现

工具	说明
bridge_quote_multi	在不存在直达路线时解析多跳路线。
bridgekitty_help	提供包含示例和工具用法的 Agent 入门指南。
xprt_onboard	为首次使用者提供引导式入门流程。

钱包工具

工具	说明
wallet_setup	使用单个助记词创建 EVM、Cosmos 和 Solana 钱包。
wallet_import	从助记词或私钥导入现有钱包。
wallet_status	显示已配置的钱包地址和密钥来源。
wallet_balance	查询所有链上的余额及其美元价格（CoinGecko）。

XPRT 质押与耕种已迁移至独立的 xprt-farming-toolkit 软件包。

示例：将 USDC 从 Base 跨链转移到 Arbitrum

默认（未签名交易）

Agent: "Bridge 100 USDC from Base to Arbitrum"

→ bridge_get_quote: Gets quotes from deBridge, Relay, LI.FI, Across
→ Shows: best rate, fees, estimated time, balance check
→ bridge_execute: Builds approval tx + bridge tx
→ Agent signs and sends both transactions
→ bridge_status: Tracks until destination confirmed

使用 sign_and_send（自动签名）

Agent: "Bridge 100 USDC from Base to Arbitrum"

→ bridge_get_quote: Gets quotes from all backends
→ bridge_execute with sign_and_send: true
  → Auto-signs approval tx + bridge tx using local wallet keys
  → Returns tx hash + explorer link
→ bridge_status: Tracks until destination confirmed

架构

Agent → MCP Tools → Routing Engine → [deBridge, Relay, LI.FI, Across, Squid]
                         ↓
                   Quote Cache (60s) + Circuit Breaker
                         ↓
                   Best Quote → buildTransaction
                         ↓
              ┌──────────┴──────────┐
              ↓                     ↓
        Unsigned TX          Signed + Broadcast
         (default)            (sign_and_send)

• 路由引擎： 并行获取所有后端的报价，并按输出金额排序
• 熔断器： 自动跳过故障后端，并逐步恢复
• 代币注册表： 包含 45+ 个已验证代币及其在各链上的规范地址
• Gas 估算器： 感知链的 Gas 成本估算，支持多 RPC 故障转移
• 余额检查器： 执行前验证代币余额和支付费用所需的原生代币余额
• 费用透明度： 在每份报价中显示协议费用（deBridge fixFee、运营费用）

安全

• 仅授权精确金额（绝不无限授权）
• 执行前模拟交易
• 已验证的代币注册表可防止地址欺骗
• MCP 协议中不包含私钥 — Agent 在外部签署交易
• sign_and_send 仅使用本地存储的密钥（绝不通过网络传输）
• 熔断器可防止故障级联
• 错误消息经过清理（不泄露密钥或路径）
• 检查 .env 文件权限并防止覆盖

已知限制

• Solana → EVM 会返回序列化交易，供外部签名（不支持自动执行）
• Relay 状态跟踪可能会将已完成的跨链交易显示为“未知”
• Solana SPL 代币尚未显示在 wallet_balance 中（仅显示原生 SOL）
• Cosmos → EVM 跨链转移尚不支持（仅支持 EVM → Cosmos）

许可证

MIT