关于 Galactic Bridge
Galactic Bridge 是面向 AI Agent 和 MCP 客户端的跨链路由查询工具,可按代币合约地址查找 LayerZero OFT 路线,并生成待签名交易。默认只读,不持有密钥或签名交易;自动签名需显式启用。
主要功能
- 01查询支持的 EVM 网络
- 02按代币地址扫描网络与 OFT 合约
- 03查询跨链路线、方向状态和费用
- 04生成待签名交易及必要的授权交易
- 05可选启用交易签名与广播
适用场景
- 01检查代币在哪些网络部署
- 02核对两条网络间的跨链路线和费用
- 03生成交易供钱包审核与签名
- 04在显式配置后自动签名并广播
MCP 相关
作为 MCP 服务,它向客户端提供网络列表、代币网络扫描和跨链路线查询工具,并可生成交易对象。设置 GB_PRIVATE_KEY 后还会提供执行交易的工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
Galactic Bridge MCP
一个 MCP 服务,可让 AI Agent 和 MCP 客户端(Claude Desktop、Cursor、……)使用 Galactic Bridge 根据代币合约地址查找 LayerZero OFT 桥接路线,并在 14 个 EVM 网络之间构建可供签名的跨链交易,包括 Stargate 等聚合器未列出的代币。
默认情况下,此服务为只读。它会查找路线并构建交易,但绝不会持有密钥或签署任何内容——这些操作由用户或钱包完成。自动签名是可选的附加功能,需要自行启用(见文末)。
功能
它只与 Galactic Bridge 的公共 API 通信,也就是网站调用的同一组端点。它不会运行在桥接服务的服务器上,也不会对其进行任何更改。
工具
| 工具 | 功能 |
|---|---|
list_supported_networks | 列出这 14 个网络,以及各自的链密钥、chainId、LayerZero eid 和原生代币符号。 |
scan_token_networks | 给定代币地址,列出该代币存在的所有网络及其在各网络上的 OFT 合约。 |
find_bridge_route | 解析两个网络之间的路线: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
示例
“将 50 个地址为 0x90e7…d9e1 的代币从 BNB Chain 桥接到 Arc,发送到我的地址 0xABC…。”
Agent 会调用 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=… 的覆盖设置。
如果未设置 GB_PRIVATE_KEY,则不会加载这些功能,服务会保持只读。
配置
| 变量 | 用途 |
|---|---|
GB_API_URL | 覆盖桥接 API 基础 URL(默认值为 https://galacticbridge.app)。 |
GB_PRIVATE_KEY | 启用自动签名。未设置 = 只读。 |
GB_RPC_<CHAIN> | 自动签名时用于对应链的 RPC URL(例如 GB_RPC_ARC)。 |
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。