NullBridge MCP
Cross-Chain Asset Bridge Agent
AI-Powered Cross-Chain Asset Bridging using thirdweb
Get Started • API Docs • Deploy • Support
______________________________________________________________________
🚀 概述
NullBridge MCP 是一个先进的人工智能驱动的跨链资产网桥代理,通过模型上下文协议(MCP)与ChatGPT集成。它专为智能Web3跨链操作而构建,使用thirdweb基础设施在多个区块链之间提供无缝的资产桥接。
✨ 主要特点
- 🌉 跨链桥接 -跨以太坊、Arbitrum、Base、Polygon、乐观主义等桥接资产
- ⚡ thirdweb集成 -由thirdwebREST API提供支持,提供可靠的桥梁基础设施
- 🔒 手动确认 -通过重定向URL进行安全交易确认
- 🤖 AI驱动 -通过ChatGPT实现自然语言桥梁交互
- 🌐 多链支持 -跨7+区块链网络的统一操作
- 💎 原生令牌支持 -使用特殊地址桥接本地代币(ETH、MATIC等)
🏗️ 建筑
该项目展示了 OpenAI应用软件开发工具包 与MCP服务器集成,具有以下特点:
- 工具注册 具有ChatGPT特定元数据
- 跨链桥 使用thirdwebREST API的功能
- 手动确认流程 通过重定向URL
- 跨源RSC 无缝导航处理
关键组件
1.MCP服务器路由(app/mcp/route.ts)
核心MCP服务器实现公开了 bridge_asset ChatGPT工具。
主要特点:
- 工具注册 具有OpenAI特定的元数据
- 桥接资产工具 用于跨链交易
- 确认URL生成 用于手动交易确认
2.桥梁代理(app/lib/bridge-agent.ts)
使用thirdwebREST API执行跨链交换的核心逻辑。
主要功能:
performCrossChainSwap-准备桥接交易并返回确认URLexecuteConfirmedSwap-在用户确认后执行桥接事务
3、API三网桥(app/lib/thirdweb-bridge-api.ts)
与第三方Web REST API直接集成,用于桥接操作。
主要功能:
bridgeSwap-通过thirdwebneneneba API执行跨链交换getBridgeChains-获得支持的链条getBridgeRoutes-获取可用的桥梁路线
4.桥梁确认页面(app/bridge/confirm/page.tsx)
用于手动交易确认的前端页面。用户查看交易详情并确认桥接操作。
🛠️ 安装
先决条件
- Node.js 18+
- npm或pnpm
- Git
- thirdweb客户端ID和密钥
快速开始
# Clone the repository
git clone https://github.com/envexx/NullBridge.git
cd NullBridge/mcp-aura
# Install dependencies
npm install
# Start development server
npm run dev
# Open http://localhost:3000环境设置
创建一个 .env.local 具有所需API密钥的文件:
# thirdweb Configuration
THIRDWEB_CLIENT_ID=your_thirdweb_client_id
THIRDWEB_SECRET_KEY=your_thirdweb_secret_key
# Optional: Base URL for production
NEXT_PUBLIC_BASE_URL=https://your-domain.com🔧 配置
测试MCP服务器
MCP服务器位于:
http://localhost:3000/mcp从ChatGPT连接
- 将您的NullBridge应用程序部署到您首选的托管平台
- 在ChatGPT中,导航到 设置→ 连接器 → 创建 并添加您的MCP服务器URL
/mcp路径(例如。,https://nullbridge.vercel.app/mcp)
注: 将MCP服务器连接到ChatGPT需要开发人员模式访问权限。请参阅 连接指南 有关设置说明。
📡 API终点
基本URL
https://your-deployment-url.vercel.app/api🌉 跨链桥
桥梁资产
POST /api/mcp/bridge-asset请求:
{
"fromChainId": 42161,
"toChainId": 8453,
"fromTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"toTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"amount": "0.1",
"toAddress": "0x742d35Cc6634C0532925a3b8D0b4E4f7E1D4D4f4",
"confirmed": false
}回复(待确认):
{
"status": "pending_confirmation",
"message": "Please confirm the transaction via the confirmation URL.",
"confirmationUrl": "https://nullbridge.vercel.app/bridge/confirm?..."
}响应(成功):
{
"status": "success",
"message": "Cross-chain swap initiated successfully.",
"transactionId": "tx_abc123",
"explorerUrl": "https://arbiscan.io/tx/0x1234..."
}🚀 部署
一键部署

手动部署
# Build for production
npm run build
# Deploy to Vercel
npm i -g vercel
vercel --prod
# Or deploy to Netlify
npm run build
npm i -g netlify-cli
netlify deploy --prod --dir .next环境变量
在部署平台中设置这些:
THIRDWEB_CLIENT_ID=your_client_id
THIRDWEB_SECRET_KEY=your_secret_key
NEXT_PUBLIC_BASE_URL=https://your-domain.com📋 支撑链
| 链名称 | 链ID | 网络类型 |
|---|---|---|
| 以太坊 | 1 | 主网 |
| 仲裁 | 42161 | 主网 |
| 基地 | 8453 | 主网 |
| 多边形 | 137 | 主网 |
| 乐观主义 | 10 | 主网 |
| 杨梅 | 421614 | 测试网 |
| 基础Sepolia | 84532 | 测试网 |
🔄 使用流程
- AI代理调用
bridge_asset带有电桥参数的工具 - 系统准备交易并返回确认URL
- 用户被重定向到确认页面(
/bridge/confirm) - 用户查看交易详情
- 用户手动确认交易
- 交易通过thirdweb执行并提交到区块链
- 用户收到交易哈希和资源管理器URL
🆘 支持与社区
- 📖 文档: docs.envexx.dev/nullbridge
- 💬 Discord 的中文翻译是“不和谐”或“纷争”。: 不一致.gg/envexx
- 🐛 问题:
- 📧 电子邮件: support@envexx.dev
📄 许可证
NullBridge MCP 由ENVXX为去中心化的未来而构建
______________________________________________________________________
Built with ❤️ by ENVXX Team
Website • Twitter • GitHub
