BridgeKitty 🐱

MCP-сервер агрегатора кроссчейн-мостов для ИИ-агентов. Один сервер, 5 бэкендов мостов, лучшие маршруты между сетями EVM, Solana и Cosmos.

BridgeKitty дает ИИ-агентам (Claude, Cursor, GPT или любому ИИ с поддержкой MCP) возможность находить и выполнять кроссчейн-переводы — с автоматической оптимизацией маршрутов, сравнением комиссий, проверкой баланса и предупреждениями о безопасности.

Последний релиз 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 — EVM → Persistence/Cosmos Hub через Squid (Axelar)

• Прозрачность комиссий протокола — deBridge fixFee, операционные расходы и общая стоимость видны в каждом предложении (котировке)

• Предупреждения о балансе — предупреждает, когда кошелек не может покрыть сумму перевода + комиссии протокола + газ

• Стейкинг XPRT — стейкинг/анстейкинг/получение наград напрямую из MCP-сервера

• Множитель фарминга — отслеживает ваш уровень стейкинга (1x → 3x → 5x) из API наград

• Автообновление котировок — истекшие котировки автоматически запрашиваются заново при выполнении (срок действия 60 секунд)

• Одобрения ERC-20 — всегда генерируются для токен-мостов (Relay + deBridge)

• Отслеживание статуса моста — ончейн-резервный вариант, когда API провайдера еще не проиндексировал транзакцию

Related MCP server: LI.FI MCP Server

Поддерживаемые мосты

Направления мостов

Быстрый старт

npx (без установки)

npx @persistenceone/bridgekitty

Claude Code

Добавьте в конфигурацию MCP (~/.claude/claude_code_config.json):

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

Cursor IDE

Добавьте в настройки MCP Cursor (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 (или в директории, из которой вы запускаете программу). Ключи никогда не покидают локальную машину.

Подпись транзакций

По умолчанию bridge_execute возвращает неподписанные транзакции для агента или пользователя, чтобы они могли подписать их извне.

Установите sign_and_send: true для включения автономной подписи — BridgeKitty будет использовать ключи кошелька, хранящиеся в ~/.bridgekitty/.env, для выполнения всего процесса:

1. Одобрение (Approval) — отправляет транзакцию одобрения 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+ верифицированных токенов с каноническими адресами для каждой сети

• Оценщик газа: Оценка стоимости газа с учетом особенностей сети и отказоустойчивостью через несколько RPC

• Проверка баланса: Проверка баланса токенов + нативного актива для оплаты комиссий перед выполнением

• Прозрачность комиссий: Комиссии протокола (deBridge fixFee, операционные расходы) отображаются в каждой котировке

Безопасность

• Одобрения только на точную сумму (никогда не безлимитные)

• Симуляция транзакции перед выполнением

• Верифицированный реестр токенов предотвращает спуфинг адресов

• Отсутствие приватных ключей в протоколе MCP — агенты подписывают транзакции извне

• sign_and_send использует только локально хранящиеся ключи (никогда не передаются по сети)

• Автоматический выключатель предотвращает каскадные сбои

• Сообщения об ошибках очищены (нет утечки ключей/путей)

• Проверка прав доступа к файлу .env + защита от перезаписи

Известные ограничения

• Solana → EVM возвращает сериализованную транзакцию для внешней подписи (нет автовыполнения)

• Отслеживание статуса Relay может показывать "unknown" для завершенных кроссчейн-переводов

• Токены Solana SPL пока не отображаются в wallet_balance (только нативный SOL)

• Перевод Cosmos → EVM пока не поддерживается (только EVM → Cosmos)

Лицензия

MIT