Galactic Bridge

Galactic Bridge MCP

AI エージェントや MCP クライアント（Claude Desktop、Cursor、…）が、MCP サーバーを通じてGalactic Bridgeを利用し、トークンコントラクトアドレスから LayerZero OFT のブリッジルートを検索して、14 の EVM ネットワーク間の署名準備済みクロスチェーントランザクションを作成できるようにします。Stargate などのアグリゲーターに掲載されていないトークンも対象です。

デフォルトでは、このサーバーは読み取り専用です。ルートを検索してトランザクションを作成しますが、秘密鍵を保持することも、署名することもありません。署名するのは人間またはウォレットです。自動署名は、自分で有効にするオプションの追加機能です（詳細は末尾を参照）。

機能

公開されている Galactic Bridge API のみを利用します。ウェブサイトが呼び出すものと同じエンドポイントです。ブリッジのサーバー上で実行されることはなく、ブリッジ側に変更を加えることもありません。

ツール

ツール	機能
list_supported_networks	14 のネットワークと、それぞれのチェーンキー、chainId、LayerZero eid、ネイティブシンボルを返します。
scan_token_networks	トークンアドレスを指定すると、そのトークンが存在するすべてのネットワークと、各ネットワーク上の OFT コントラクトを返します。
find_bridge_route	2 つのネットワーク間のルートを解決します。OFT コントラクト、現在その方向が有効かどうか、手数料を返します。さらに amount と recipient を指定すると、署名準備済みトランザクションも返します（トークンが別のアダプターを経由してブリッジされる場合は、ERC-20 承認トランザクションも含まれます）。

find_bridge_route が署名や送信を行うことはありません。確認して自分のウォレットで署名できるよう、トランザクションオブジェクト（{ to, data, value, chainId }）を返します。

インストール

Node.js 18 以降が必要です。

Claude Desktop

claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "galactic-bridge": {
      "command": "npx",
      "args": ["-y", "galactic-bridge-mcp"]
    }
  }
}

Cursor／その他の MCP クライアント

クライアントのコマンドに npx -y galactic-bridge-mcp を指定します（stdio トランスポート）。

ソースからインストール

git clone https://github.com/mckellen-eth/galactic-bridge-mcp.git
cd galactic-bridge-mcp
npm install
npm run build
node dist/index.js

使用例

「トークン 0x90e7…d9e1 を 50、BNB Chain から Arc へ、アドレス 0xABC…にブリッジして」

エージェントは find_bridge_route を呼び出し、手数料と署名準備済みトランザクションを受け取ります。内容を確認し、ウォレットで署名してください。トークンが別のアダプターを使用する場合は、先に署名する承認トランザクションも返されます。

安全性

• デフォルトでは秘密鍵を使用しません。 読み取り専用ツールが秘密鍵を参照することはありません。
• 署名するのはご自身です。 トランザクションは確認用に返され、署名はご自身のウォレットで行います。
• 手数料と小数桁数はリアルタイムで取得します。 そのため金額は正確です。トークンで無効化されている方向については、実行時にリバートするトランザクションを返す代わりに、その旨を通知します。

署名する前に、必ずトランザクションを確認してください。本ソフトウェアは現状有姿で提供され、保証はありません（MIT）。

---

オプション：自動署名（上級者向け）

環境変数に秘密鍵を設定すると、サーバー自身でトランザクションに署名してブロードキャストできます。これにより実資金が取り消し不能な形で移動します。デフォルトでは無効です。 リスクを理解している場合にのみ有効にし、損失しても問題のない額だけを保有する専用のホットウォレットを使用してください。

{
  "mcpServers": {
    "galactic-bridge": {
      "command": "npx",
      "args": ["-y", "galactic-bridge-mcp"],
      "env": {
        "GB_PRIVATE_KEY": "0xyourHotWalletKey"
      }
    }
  }
}

GB_PRIVATE_KEY を設定すると、追加のツール execute_bridge が利用できるようになります。このツールはブリッジトランザクションを作成、署名、ブロードキャストします（必要な場合は、先に承認トランザクションを実行します）。オプションの ethers パッケージ（npm install ethers）が必要です。また、組み込みの公開 RPC がないネットワークでは、GB_RPC_BSC=… のような設定で RPC を指定してください。

GB_PRIVATE_KEY が設定されていなければ、これらの機能は読み込まれず、サーバーは読み取り専用のままです。

設定

変数	用途
GB_API_URL	ブリッジ API のベース URL を上書きします（デフォルトは https://galacticbridge.app）。
GB_PRIVATE_KEY	自動署名を有効にします。未設定の場合は読み取り専用です。
GB_RPC_<CHAIN>	自動署名でそのチェーンに使用する RPC URL（例：GB_RPC_ARC）。