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, 운영 비용 및 총 비용 확인 가능

• 잔액 경고 — 지갑이 브리지 금액 + 프로토콜 수수료 + 가스비를 충당할 수 없을 때 경고

• 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 설정(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. 승인 — ERC-20 승인 트랜잭션 전송 (필요한 경우)

2. 재구성 — 업데이트된 논스(nonce)로 브리지 트랜잭션 재조회 (승인이 전송된 경우)

3. 시뮬레이션 — eth_estimateGas 사전 확인 실행

4. 서명 — 로컬 개인 키로 트랜잭션 서명

5. 브로드캐스트 — 체인에 제출하고 tx 해시 + 탐색기 링크 반환

선택적 API 키

MCP 도구

핵심 브리지 도구

멀티홉 및 탐색

지갑 도구

XPRT 스테이킹 및 파밍은 독립형 xprt-farming-toolkit 패키지로 이동되었습니다.

예시: Base에서 Arbitrum으로 USDC 브리지

기본 (서명되지 않은 트랜잭션)

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 상태 추적은 완료된 크로스체인 브리지에 대해 "알 수 없음"으로 표시될 수 있습니다.

• Solana SPL 토큰은 아직 wallet_balance에 표시되지 않습니다 (네이티브 SOL만 표시)

• Cosmos → EVM 브리징은 아직 지원되지 않습니다 (EVM → Cosmos만 지원)

라이선스

MIT