BridgeKitty 🐱

面向 AI 代理的跨链桥聚合器 MCP 服务器。一个服务器，5 个桥接后端，提供跨 EVM、Solana 和 Cosmos 链的最佳路由。

BridgeKitty 为 AI 代理（Claude、Cursor、GPT 或任何兼容 MCP 的 AI）提供了查找和执行跨链桥接转账的能力——具备自动路由优化、费用比较、余额检查和安全警告功能。

最新 npm 版本： @persistenceone/bridgekitty@0.3.9

v0.3.9 更新内容

• 提取 XPRT 工具 — 质押、奖励和挖矿工具已移至独立的 xprt-farming-toolkit 包中

• 移除 Persistence Interop 后端 — BridgeKitty 现在专注于 5 个后端（deBridge、Relay、LI.FI、Across、Squid）的桥接聚合

• 精简表面积 — 工具更少，代理的范围更清晰

• sign_and_send 参数 — 代理现在可以使用本地存储的钱包密钥直接签名并广播交易

• 完整的 EVM 签名支持 — 适用于所有 EVM 后端（Across、Relay、LI.FI、Squid、deBridge）+ Persistence Interop (EIP-712)

• 模拟修复 — ERC20 桥接现在可以在新钱包上正常工作（之前因过早模拟而被阻止）

• Solana 签名 — 将在下个版本中推出

• Solana 支持 — EVM ↔ Solana 双向桥接（原生 SOL 交付，非封装代币）

• Cosmos 支持 — 通过 Squid (Axelar) 实现 EVM → Persistence/Cosmos Hub

• 协议费用透明度 — deBridge fixFee、运营费用和总成本在每次报价中均可见

• 余额警告 — 当钱包无法支付桥接金额 + 协议费用 + Gas 时发出警告

• XPRT 质押 — 直接从 MCP 服务器进行质押/取消质押/领取奖励

• 挖矿乘数 — 从奖励 API 跟踪您的质押等级 (1x → 3x → 5x)

• 报价自动刷新 — 过期的报价在执行时会自动重新获取（60秒过期）

• ERC-20 授权 — 始终为代币桥接生成（Relay + deBridge）

• 桥接状态跟踪 — 当提供商 API 尚未索引时提供链上回退

Related MCP server: deBridge MCP Server

支持的桥接

桥接方向

快速入门

npx (无需安装)

npx @persistenceone/bridgekitty

Claude Code

添加到您的 MCP 配置 (~/.claude/claude_code_config.json)：

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

Cursor IDE

添加到 Cursor 的 MCP 设置（设置 > MCP 服务器）：

{
  "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（或您运行所在的目录）中。密钥永远不会离开本地机器。

交易签名

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

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

1. 授权 — 发送 ERC-20 授权交易（如果需要）

2. 重建 — 使用更新后的 nonce 重新获取桥接交易（如果已发送授权）

3. 模拟 — 运行 eth_estimateGas 预检检查

4. 签名 — 使用本地私钥对交易进行签名

5. 广播 — 提交到链上并返回交易哈希 + 区块浏览器链接

可选 API 密钥

MCP 工具

核心桥接工具

多跳与发现

钱包工具

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 估算器： 具有多 RPC 故障转移功能的链感知 Gas 成本估算

• 余额检查器： 在执行前验证代币 + 原生余额以支付费用

• 费用透明度： 协议费用（deBridge fixFee、运营费用）在每次报价中均会显示

安全性

• 仅精确金额授权（从不无限授权）

• 执行前进行交易模拟

• 经过验证的代币注册表可防止地址欺骗

• MCP 协议中不包含私钥 — 代理在外部对交易进行签名

• sign_and_send 仅使用本地存储的密钥（从不通过网络传输）

• 断路器防止级联故障

• 错误消息已清理（无密钥/路径泄露）

• .env 文件权限检查 + 覆盖保护

已知限制

• Solana → EVM 返回用于外部签名的序列化交易（无自动执行）

• Relay 状态跟踪 对于已完成的跨链桥接可能显示“未知”

• Solana SPL 代币 尚未在 wallet_balance 中显示（仅限原生 SOL）

• Cosmos → EVM 桥接尚不支持（仅支持 EVM → Cosmos）

许可证

MIT