Layerzero MCP

🚀 LayerZero OFT MCP 服務器

LayerZero OFT MCP 是一個基於 TypeScript/Node.js 的模型上下文協議（MCP）服務器，用於在多個區塊鏈上創建、部署和橋接跨鏈可替代代幣（OFTs）。交互主要通過 ethers.js 進行管理，利用 LayerZero 合約和協議實現跨鏈通信。

這個 MCP 通過提供一個結構化、上下文感知的層來抽象跨鏈代幣創建和跨鏈交互的複雜性，用於啟動、管理和橋接 OFT。它旨在與需要安全可靠地訪問去中心化跨鏈功能的大語言模型（LLM）代理、機器人或應用程序輕鬆集成。

確定性跨鏈合約尋址
MCP 使用 Solidity 的 CREATE2 操作碼在每個鏈上的相同地址部署 OFT 合約。 該地址由字節碼和固定鹽派生而來，其中固定鹽目前包括 代幣名稱和符號。部署時請確保使用唯一標識符，因為不能使用同一工廠兩次創建相同的代幣（相同名稱和符號）。

這是一個可行的起點。你可以引入自己的 OFT 合約，並通過自定義功能或代幣邏輯對其進行擴展。該系統在設計上是開放且可擴展的。

✨ 主要特性

這個 MCP 服務器提供了以下交互工具：

1. deploy-and-configure-oft-multichain

• 描述：將跨鏈可替代代幣（OFT）合約部署到一個或多個指定的支持 LayerZero 的鏈上。部署成功後，它會將每個新的 OFT 合約配置為與集合中所有其他新部署的 OFT 合約成為對等合約。它還會在每個合約上設置標準強制選項（例如，設置 gas 限制），以實現向其對等合約的跨鏈轉移。
• 參數：
  • tokenName（字符串）：代幣名稱（例如，"MyToken"）。
  • tokenSymbol（字符串）：代幣符號（例如，"MYT"）。
  • initialTotalSupply（字符串）：代幣的總供應量，以人類可讀的格式表示（例如，"1000000"）。這將使用 decimals 值進行解析。
  • decimals（數字，可選，默認值：18）：代幣的小數位數。
  • targetChains（字符串數組）：要部署和配置 OFT 的鏈名稱列表（來自 utils.ts 中配置的 NETWORKS，例如，["Arbitrum sepolia", "baseSepolia"]）。必須至少選擇一個鏈。要實現對等連接，必須指定至少兩個鏈併成功部署合約。
  • owner（字符串，可選）：部署合約的以太坊地址。如果未提供，則默認為 .env 文件中設置的 OWNER_ADDRESS。
• 輸出：詳細說明每個目標鏈上的部署成功或失敗情況、它們之間的對等狀態以及設置強制選項的狀態。

2. bridge-oft

• 描述：使用 LayerZero 將 OFT 代幣從一個鏈橋接到另一個鏈。
• 參數：
  • tokenAddress（字符串）：源鏈上 OFT 合約的地址。
  • amount（字符串）：要橋接的代幣數量（例如，"100"）。假設使用 18 位小數進行解析；如果你的代幣使用不同的小數位數，請相應修改工具。
  • fromChain（字符串）：源鏈名稱（例如，"Arbitrum sepolia"）。
  • toChain（字符串）：目標鏈名稱（例如，"baseSepolia"）。
  • receiverAddress（字符串）：目標鏈上接收代幣的地址。
  • extraOptions（字符串，可選，默認值："0x"）：LayerZero 消息執行的額外選項。
• 輸出：橋接交易的詳細信息，包括交易哈希。

📚 詳細文檔

⚠️ 重要提示

在運行服務器之前，你必須將以下路徑替換為你的合約工件的絕對路徑：

// --- index.ts ---  
// 將這些路徑替換為你的 OFT 合約的實際 ABI 和字節碼 JSON 文件路徑（例如，來自 MyOFT.sol）  
const oftPath = resolve(  
  "D:\\Dev\\layerzero-mcp\\artifacts\\MyOFT\\MyOFT.json"  
);  
// 工廠合約的路徑也一樣  
// 這應該指向 CREATE2Factory 的 ABI 和字節碼 JSON 文件  
const factoryPath = resolve(  
  "D:\\Dev\\layerzero-mcp\\artifacts\\factory\\CREATE2Factory.json"  
);  
// --- --- ---  

如果不這樣做，在嘗試使用 deploy-and-configure-oft-multichain 工具時將導致錯誤。bridge-oft 工具也需要正確設置 OFT_ABI 才能與現有合約進行交互。

📦 安裝指南

前提條件

• Node.js（建議使用 v16 或更高版本）
• npm 或 yarn
• 能夠通過模型上下文協議進行通信的大語言模型（LLM）或應用程序（例如，Claude for Desktop）。

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/your-username/layerzero-oft-mcp.git
   cd layerzero-oft-mcp
   

2. 安裝依賴項：

   npm install
   # 或者
   yarn install
   

3. 創建 .env 文件： 複製 .env.example（如果提供）或在項目根目錄下創建一個新的 .env 文件，並填充你的詳細信息：

   PRIVATE_KEY="your_hex_encoded_private_key_here"
   OWNER_ADDRESS="your_owner_ethereum_address_here"
   ARBITRUM_SEPOLIA_RPC_URL="your_Arbitrum sepolia_testnet_rpc_url_here"
   BASE_SEPOLIA_RPC_URL="your_base_sepolia_testnet_rpc_url_here"
   ARBITRUM_FACTORY_ADDRESS="0x754a2643Ce68e0e34510B1E246254f93946AE3a1"
   BASE_FACTORY_ADDRESS="0x754a2643Ce68e0e34510B1E246254f93946AE3a1"
   
   # 如果你在 utils.ts 中配置了更多網絡，請添加其他 RPC URL 環境變量
   

   安全注意事項： 切勿將包含私鑰的 .env 文件提交到公共倉庫。

4. 更新 ABI 和字節碼： 如上述“重要提示”部分所述，打開 layerzero-mcp.ts 並將 OFT_ABI 和 OFT_BYTECODE 佔位符替換為你的實際合約詳細信息。

5. 構建項目（如果使用 TypeScript 編譯）：

   npm run build
   # 或者
   yarn run build
   

   （此命令假設你的 package.json 中有一個 build 腳本，用於將 TypeScript 編譯為 JavaScript，例如，tsc）

為 Claude for Desktop 配置 MCP（示例）

將 MCP 配置添加到你的 Claude for Desktop 配置文件中（通常位於 Windows 上的 C:\Users\{User}\AppData\Roaming\Claude\claude_desktop_config.json）：

{
    "layerzero-oft-mcp": {
        "command": "node",
        "args": [
            "<PROJECT_ABSOLUTE_FILEPATH>/build/index.js"
        ],
        "env": {
            "PRIVATE_KEY": "your_hex_encoded_private_key_here",
            "OWNER_ADDRESS": "your_owner_ethereum_address_here",
            "ARBITRUM_SEPOLIA_RPC_URL": "your_Arbitrum_sepolia_testnet_rpc_url_here",
            "BASE_SEPOLIA_RPC_URL": "your_base_sepolia_testnet_rpc_url_here",
            "ARBITRUM_FACTORY_ADDRESS": "0x754a2643Ce68e0e34510B1E246254f93946AE3a1",
            "BASE_FACTORY_ADDRESS": "0x754a2643Ce68e0e34510B1E246254f93946AE3a1"
        }
    }
}

• 將 <PROJECT_ABSOLUTE_FILEPATH> 替換為你的項目目錄的實際絕對路徑。
• 確保此處的 env 變量與你的服務器所需的變量相匹配，或者如果你的 Node.js 設置加載了這些變量（腳本中的 dotenv.config() 調用應該處理這個問題），則確保它們能正確從 .env 文件中獲取。對於 Claude Desktop，需要在 claude_desktop_config.json 中明確設置這些變量。

有關使用 Claude for Desktop 進行測試的更多詳細信息，請遵循官方 MCP 指南。

運行應用程序及示例用法

配置完成（包括 ABI/字節碼和環境變量）後，MCP 服務器將在需要時由宿主應用程序（例如，Claude for Desktop）啟動。

如果你使用大語言模型，就可以使用自然語言提示與其進行交互。例如：

部署和配置新的 OFT： "在 Arbitrum sepolia 和 Base Sepolia 測試網上部署一個名為 'OmniCoin'（OMC）、總供應量為 500,000 個代幣的新 OFT。"

這將使用 deploy-and-configure-oft-multichain 工具。

橋接現有 OFT 代幣： "將 50 個 MyOFT 從 Arbitrum sepolia 橋接到 Base Sepolia 的地址 0x123...abc。該代幣在 Arbitrum sepolia 上的部署地址為 0xabc...123。"

這將使用 bridge-oft 工具。

⚠️ 重要提示

請確保與你的 PRIVATE_KEY 關聯的賬戶在相應鏈上有足夠的 gas 代幣（例如，測試網 ETH 或 MATIC），以支付部署和橋接交易費用。

💻 使用示例

部署 OFT

橋接 OFT