bridgekitty

BridgeKitty 🐱

AI エージェント向けのクロスチェーンブリッジアグリゲーター MCP サーバーです。1 つのサーバーで 5 つのブリッジバックエンドを利用でき、EVM、Solana、Cosmos チェーン間の最適なルートを選択します。

BridgeKitty を使うと、AI エージェント（Claude、Cursor、GPT、または MCP 互換の AI）は、クロスチェーンブリッジ送金の検索と実行ができます。ルートの自動最適化、手数料の比較、残高チェック、安全性に関する警告にも対応しています。

最新の npm リリース： @persistenceone/[email protected]

v0.3.9 の新機能

• XPRT ツールを切り出し — ステーキング、報酬、ファーミングのツールをスタンドアロンの xprt-farming-toolkit パッケージに移動しました
• Persistence Interop バックエンドを削除 — BridgeKitty は 5 つのバックエンド（deBridge、Relay、LI.FI、Across、Squid）を扱うブリッジアグリゲーターになりました
• 機能範囲を縮小 — ツールを減らし、エージェントが把握しやすい範囲に明確化しました

v0.3.0 の新機能

• sign_and_send パラメーター — ローカルに保存されたウォレットキーを使って、エージェントがトランザクションに署名し、直接ブロードキャストできるようになりました
• 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、運営費、合計コストをすべての見積もりで確認できます
• 残高警告 — ウォレットの残高がブリッジ額、プロトコル手数料、ガス代の合計に満たない場合に警告します
• XPRT ステーキング — MCP サーバーから直接、ステーキング、ステーキング解除、報酬の請求ができます
• ファーミング倍率 — 報酬 API からステーキング階層（1x → 3x → 5x）を追跡します
• 見積もりの自動更新 — 期限切れの見積もりは、実行時に自動で再取得されます（有効期限は 60 秒）
• ERC-20 の承認 — トークンブリッジでは常に生成されます（Relay + deBridge）
• ブリッジのステータス追跡 — プロバイダー API でまだインデックスされていない場合、オンチェーンのフォールバックを使用します

対応ブリッジ

バックエンド	種類	チェーン	強み
deBridge (DLN)	直接型	EVM + Solana	インテントベースの高速な約定、Solana に対応
Relay	直接型	EVM + Solana	プロトコル手数料なし、ガスを最適化
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 の秘密鍵（16 進数）
MNEMONIC	BIP-39 ニーモニック（EVM、Cosmos、Solana のキーを導出します）
SOLANA_PRIVATE_KEY	Solana の秘密鍵（base58）

トランザクション署名

デフォルトでは、bridge_execute はエージェントまたはユーザーが外部で署名するための未署名トランザクションを返します。

sign_and_send: true を設定すると、自動署名が有効になります。BridgeKitty は ~/.bridgekitty/.env に保存されたウォレットキーを使用して、次の一連の処理を実行します。

1. 承認 — 必要に応じて ERC-20 承認トランザクションを送信します
2. 再構築 — 承認を送信した場合は、nonce を更新してブリッジトランザクションを再取得します
3. シミュレーション — eth_estimateGas による事前チェックを実行します
4. 署名 — ローカルの秘密鍵でトランザクションに署名します
5. ブロードキャスト — チェーンに送信し、tx ハッシュとエクスプローラーのリンクを返します

オプションの 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	例とツールの使い方を含む、エージェント向けのオンボーディングガイドです。
xprt_onboard	初回ユーザー向けのガイド付きオンボーディングフローです。

ウォレットツール

ツール	説明
wallet_setup	1 つのニーモニックから EVM、Cosmos、Solana のウォレットを作成します。
wallet_import	ニーモニックまたは秘密鍵から既存のウォレットをインポートします。
wallet_status	設定済みのウォレットアドレスとキーの取得元を表示します。
wallet_balance	USD 価格（CoinGecko）とともに、すべてのチェーンの残高を確認します。

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 は、外部で署名するためのシリアライズ済みトランザクションを返します（自動実行には対応していません）
• リレーのステータス追跡では、完了したクロスチェーンブリッジが「unknown」と表示される場合があります
• Solana SPL トークンはまだ wallet_balance に表示されません（ネイティブ SOL のみ）
• Cosmos → EVM のブリッジにはまだ対応していません（EVM → Cosmos のみ）

ライセンス

MIT