Layerzero MCP

🚀 LayerZero OFT MCP Server

LayerZero OFT MCPは、複数のブロックチェーン間でOmnichain Fungible Tokens (OFTs)を作成、デプロイ、ブリッジするためのTypeScript/Node.jsモデルコンテキストプロトコル（MCP）サーバーです。主にethers.jsを介して相互作用が管理され、LayerZeroのコントラクトとプロトコルを利用して、クロスチェーン通信を行います。

このMCPは、OFTの作成、管理、およびブリッジを開始するための構造化されたコンテキスト認識レイヤーを提供することで、オムニチェーントークンの作成とクロスチェーン相互作用の複雑さを抽象化します。分散型クロスチェーン機能への安全で信頼性の高いアクセスが必要なLLMエージェント、ボット、またはアプリケーションとの簡単な統合を目的として設計されています。

決定論的なクロスチェーンコントラクトアドレッシング
MCPは、SolidityのCREATE2オペコードを使用して、すべてのチェーン上で同じアドレスにOFTコントラクトをデプロイします。 アドレスは、バイトコードと固定ソルトから導出されます。現在はトークン名とシンボルが含まれています。同じファクトリを使用して同じトークン（同じ名前とシンボル）を2回作成することはできないため、デプロイ時に一意の識別子を使用するようにしてください。

これは動作する出発点です。独自のOFTコントラクトを持ち込み、カスタム機能やトークンロジックで拡張することができます。システムは設計上、オープンで拡張可能です。

✨ 主な機能

このMCPサーバーは、以下のツールを公開しています。

1. deploy-and-configure-oft-multichain

• 説明：指定された1つ以上のLayerZero対応チェーンにOmnichain Fungible Token (OFT)コントラクトをデプロイします。デプロイが成功すると、各新しいOFTコントラクトがセット内の他のすべての新しくデプロイされたOFTとピアになるように構成されます。また、各コントラクトに標準の強制オプション（例：ガス制限）を設定して、ピアへのクロスチェーン転送を可能にします。
• パラメータ：
  • tokenName (文字列)：トークンの名前（例："MyToken"）。
  • tokenSymbol (文字列)：トークンのシンボル（例："MYT"）。
  • initialTotalSupply (文字列)：人間が読める形式のトータルサプライ（例："1000000"）。これはdecimals値を使用して解析されます。
  • decimals (数値、オプション、デフォルト: 18)：トークンの小数点以下の桁数。
  • targetChains (文字列の配列)：OFTをデプロイおよび構成するチェーン名のリスト（utils.tsで構成されたNETWORKSから、例：["Arbitrum sepolia", "baseSepolia"]）。少なくとも1つを選択する必要があります。ピアリングを行うには、少なくとも2つのチェーンを指定し、デプロイが成功する必要があります。
  • owner (文字列、オプション)：デプロイされたコントラクトの所有者となるEthereumアドレス。指定されない場合は、.envファイルに設定されたOWNER_ADDRESSがデフォルトとなります。
• 出力：各ターゲットチェーンでのデプロイの成否、それらの間のピアリング状態、および強制オプションの設定状態の詳細。

2. bridge-oft

• 説明：LayerZeroを使用して、OFTトークンを1つのチェーンから別のチェーンにブリッジします。
• パラメータ：
  • 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にTypeScriptをJavaScriptにコンパイルするbuildスクリプトがあることを前提としています。例：tsc）

Claude for Desktop用のMCPを構成する（例）

Claude for Desktopの構成ファイル（Windowsでは通常C:\Users\{User}\AppData\Roaming\Claude\claude_desktop_config.jsonにあります）にMCP構成を追加します。

{
    "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の設定が.envファイルからそれらを正しく取得するようにします（スクリプト内のdotenv.config()呼び出しがこれを処理するはずです）。Claude Desktopの場合は、claude_desktop_config.jsonで明示的に設定する必要があります。

Claude for Desktopでのテストに関する詳細は、公式のMCPガイドを参照してください。

アプリケーションの実行と使用例

構成が完了したら（ABI/バイトコードと環境変数を含む）、MCPサーバーは必要に応じてホストアプリケーション（例：Claude for Desktop）によって起動されます。

LLMを使用する場合は、自然言語のプロンプトを使用してサーバーと対話できます。例えば：

新しいOFTをデプロイして構成するには： "Arbitrum sepoliaとBase Sepoliaの両方のテストネットワークに、総供給量500,000トークンの'OmniCoin'（OMC）という名前の新しいOFTをデプロイして構成してください。"

これはdeploy-and-configure-oft-multichainツールを使用します。

既存のOFTトークンをブリッジするには： "Arbitrum sepoliaからBase Sepoliaに50のMyOFTをアドレス0x123...abcにブリッジしてください。トークンはArbitrum sepolia上の0xabc...123にデプロイされています。"

これはbridge-oftツールを使用します。

注意：PRIVATE_KEYに関連付けられたアカウントが、デプロイとブリッジトランザクションの手数料をカバーするのに十分なガストークン（例：テストネットのETHまたはMATIC）をそれぞれのチェーン上に持っていることを確認してください。

📷 スクリーンショット例

OFTのデプロイ

OFTのブリッジ