BridgeKitty 🐱

Servidor MCP de agregador de puentes multicadena para agentes de IA. Un servidor, 5 backends de puentes, las mejores rutas a través de cadenas EVM, Solana y Cosmos.

BridgeKitty ofrece a los agentes de IA (Claude, Cursor, GPT o cualquier IA compatible con MCP) la capacidad de encontrar y ejecutar transferencias de puentes multicadena, con optimización automática de rutas, comparación de comisiones, comprobaciones de saldo y advertencias de seguridad.

Última versión de npm: @persistenceone/bridgekitty@0.3.9

Novedades en la v0.3.9

• Herramientas XPRT extraídas — las herramientas de staking, recompensas y farming se han movido al paquete independiente xprt-farming-toolkit

• Backend de interoperabilidad de Persistence eliminado — BridgeKitty es ahora un agregador de puentes enfocado en 5 backends (deBridge, Relay, LI.FI, Across, Squid)

• Superficie más reducida — menos herramientas, alcance más claro para los agentes

• Parámetro sign_and_send — los agentes ahora pueden firmar y transmitir transacciones directamente usando claves de billetera almacenadas localmente

• Soporte completo de firma EVM — funciona con todos los backends EVM (Across, Relay, LI.FI, Squid, deBridge) + Interoperabilidad de Persistence (EIP-712)

• Corrección de simulación — los puentes ERC20 ahora funcionan en billeteras nuevas (anteriormente bloqueados por una simulación prematura)

• Firma de Solana — llegará en la próxima versión

• Soporte para Solana — puente bidireccional EVM ↔ Solana (entrega de SOL nativo, no envuelto)

• Soporte para Cosmos — EVM → Persistence/Cosmos Hub vía Squid (Axelar)

• Transparencia en las comisiones del protocolo — deBridge fixFee, gastos operativos y coste total visibles en cada presupuesto

• Advertencias de saldo — avisa cuando la billetera no puede cubrir el importe del puente + comisiones del protocolo + gas

• Staking de XPRT — haga staking/unstake/reclame recompensas directamente desde el servidor MCP

• Multiplicador de farming — rastrea su nivel de staking (1x → 3x → 5x) desde la API de recompensas

• Actualización automática de presupuestos — los presupuestos caducados se vuelven a obtener automáticamente al ejecutar (caducidad de 60s)

• Aprobaciones ERC-20 — siempre generadas para puentes de tokens (Relay + deBridge)

• Seguimiento del estado del puente — respaldo en cadena cuando la API del proveedor aún no ha indexado

Related MCP server: deBridge MCP Server

Puentes soportados

Direcciones de puente

Inicio rápido

npx (instalación cero)

npx @persistenceone/bridgekitty

Claude Code

Añadir a su configuración de MCP (~/.claude/claude_code_config.json):

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

Cursor IDE

Añadir a la configuración de MCP de Cursor (Settings > MCP Servers):

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

Claude Desktop

Añadir a claude_desktop_config.json:

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

Configuración de la billetera

BridgeKitty puede gestionar billeteras para puentes autónomos. Ejecute wallet_setup para crear billeteras para EVM, Cosmos y Solana, o proporcione sus propias direcciones en los presupuestos.

La configuración de la billetera se almacena en ~/.bridgekitty/.env (o en el directorio desde el que ejecute). Las claves nunca salen de la máquina local.

Firma de transacciones

Por defecto, bridge_execute devuelve transacciones sin firmar para que el agente o el usuario las firme externamente.

Establezca sign_and_send: true para habilitar la firma autónoma: BridgeKitty utilizará las claves de billetera almacenadas en ~/.bridgekitty/.env para gestionar el flujo completo:

1. Aprobación — envía la transacción de aprobación ERC-20 (si es necesario)

2. Reconstrucción — vuelve a obtener la transacción del puente con el nonce actualizado (si se envió la aprobación)

3. Simulación — ejecuta la comprobación previa eth_estimateGas

4. Firma — firma la transacción con la clave privada local

5. Transmisión — envía a la cadena y devuelve el hash de la transacción + enlace al explorador

Claves API opcionales

Herramientas MCP

Herramientas principales de puente

Multi-salto y descubrimiento

Herramientas de billetera

El staking y farming de XPRT se ha movido al paquete independiente xprt-farming-toolkit.

Ejemplo: Puente de USDC de Base a Arbitrum

Por defecto (transacciones sin firmar)

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

Con sign_and_send (firma autónoma)

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

Arquitectura

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)

• Motor de enrutamiento: Presupuestos paralelos de todos los backends, clasificados por importe de salida

• Disyuntor: Omite automáticamente los backends que fallan, recuperación gradual

• Registro de tokens: Más de 45 tokens verificados con direcciones canónicas por cadena

• Estimador de gas: Estimación de costes de gas consciente de la cadena con conmutación por error multi-RPC

• Comprobador de saldo: Valida el saldo del token + nativo para las comisiones antes de la ejecución

• Transparencia de comisiones: Comisiones de protocolo (deBridge fixFee, gastos operativos) mostradas en cada presupuesto

Seguridad

• Aprobaciones de importe exacto solamente (nunca ilimitadas)

• Simulación de transacciones antes de la ejecución

• El registro de tokens verificados evita la suplantación de direcciones

• No hay claves privadas en el protocolo MCP: los agentes firman las transacciones externamente

• sign_and_send utiliza solo claves almacenadas localmente (nunca transmitidas por la red)

• El disyuntor evita fallos en cascada

• Mensajes de error saneados (sin fugas de claves/rutas)

• Comprobaciones de permisos de archivos .env + protección contra sobrescritura

Limitaciones conocidas

• Solana → EVM devuelve una transacción serializada para firma externa (sin ejecución automática)

• El seguimiento del estado de Relay puede mostrar "desconocido" para puentes multicadena completados

• Los tokens SPL de Solana aún no se muestran en wallet_balance (solo SOL nativo)

• El puenteo Cosmos → EVM aún no está soportado (solo EVM → Cosmos)

Licencia

MIT