Layer2 MCP Server

Layer2 MCP Server

開発や利用のために Ethereum レイヤー 2 ネットワークとやり取りするモデルコンテキストプロトコルサーバーです。AI モデルがブロックチェーンネットワークとやり取りし、トークンをデプロイしてトランザクションを管理するための標準化されたインターフェースを提供します。

概要

MCP Layer2 サーバーは Model Context Protocol の仕様を実装し、AI モデルに次のツールを提供します。

1. 基本

• 新しい ERC20 トークンコントラクトをデプロイする
• 指定したアドレスに ETH を送金する
• 指定したアドレスに ERC20 トークンを送金する
• テストやシミュレーションのために、ランダムなアドレスへ一括送金を実行する

2. 応用

• L1 の決済とデータ可用性の検証
• クロスチェーンに対応

この実装により、AI アシスタントは標準化されたプロトコルを通じてブロックチェーンネットワークと直接やり取りできます。これによって、AI ワークフローにブロックチェーン機能を簡単に統合できます。

使用例

AI アシスタントがこれらのツールを使用する例を以下に示します。

1. 新しい ERC20 トークンコントラクトをデプロイする：

   👤You: Deploy a new ERC20 token
   
   🤖AI: I'll deploy a new ERC20 token contract for you.
   [Tool call: deployToken]
   Result: Token deployed successfully!
           Contract Address: 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
           Transaction Hash: 0xd4ec9bf7ca67a581e78a8637974cd84c9c3524a75efe8851b808f0d58879ebd9
   

2. アドレスにトークンを送金する：

   👤You: Transfer 100 erc20 tokens to the address 0x6ea5e8971eC8cf32d43AeB18a6999aFc3a3ec65d
   
   🤖AI: I need to deploy an ERC20 token contract before I can transfer 100 ERC20 tokens to a specified address.
   [Tool call: deployToken]
   Result: Token deployed successfully!
           Contract Address: 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
           Transaction Hash: 0xd4ec9bf7ca67a581e78a8637974cd84c9c3524a75efe8851b808f0d58879ebd9
   
   🤖AI: Now I will use the ERC20 token contract I just deployed to transfer 100 tokens to the address 0x6ea5e8971eC8cf32d43AeB18a6999aFc3a3ec65d.
   
   [Tool call: transferToken with tokenAddress=0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512, 
               targetAddress=0x6ea5e8971eC8cf32d43AeB18a6999aFc3a3ec65d]
               
   🤖AI: ERC20 token transfer has been successfully completed!
   Details:
   Token contract address: 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
   Receiving address: 0x6ea5e8971eC8cf32d43AeB18a6999aFc3a3ec65d
   Transfer transaction hash: 0x82b7bdc69ffebfc946ab5101cf853a06e64d5aceaf96ca4fe70622fcee89d83e
   The token has been successfully transferred to the specified address. Do you need to perform other operations?
   

3. アドレスに ETH を送金する：

   🤖AI: I'll transfer 10 ETH to the specified address.
   [Tool call: transferETH with targetAddress=0x6ea5e8971eC8cf32d43AeB18a6999aFc3a3ec65d, amount=10]
   Result: ETH transfer successful!
           Transaction Hash: 0x9f46076f1c9b84d49c7314d8b8586e20c5c5b389ec56931e510408b3f6052bac
   

4. 一括送金を実行する：

   🤖AI: I'll execute 100 token transfers over 10 seconds.
   [Tool call: batchTransfer with tokenAddress=0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512, 
               transactionCount=100, durationSeconds=10]
   Result: Batch transfer initiated!
           Processing 100 transactions over 10 seconds.
   

インストール

# Clone the repository
git clone https://github.com/anylots/layer2-mcp.git
cd layer2-mcp

# Install dependencies
npm install

# Build the project
npm run build

使用方法

設定

ルートディレクトリに .env ファイルを作成し、次の変数を設定します。

PRIVATE_KEY=your_ethereum_private_key
ETH_L2_RPC=your_layer2_rpc_url

Cursor での使用

Cursor の MCP 設定パネルで、コマンドタイプの MCP サーバーを追加し、実行コマンドを入力します。例：node \\wsl.localhost\Ubuntu-22.04\root\xxxx\xxxx\layer2-dev\build\index.js

Claude Desktop での使用

1. Claude Desktop をインストールします
2. 次の設定で新しい MCP サーバーを追加します。

    "layer2-mcp": {
      "command": "node",
      "args": [
        "/path-to-layer2-mcp/build/src/index.js"
      ],
      "env": {
        "PRIVATE_KEY": "<<your eth-wallet private key>>",
        "ETH_L2_RPC": "<<The layer2 chain rpc you want to interact with>>"
      }
    }
   

3. これで、Claude の会話でツールを使用できるようになります。

MCP Inspector でのテスト

1. MCP Inspector をインストールします。

   npm install -g @modelcontextprotocol/inspector
   

2. サーバーを起動します。

   npm start
   

3. 別のターミナルで、インスペクターを実行します。

   mcp-inspector
   

4. ブラウザーで http://localhost:5173 を開き、ツールを操作します。

利用可能なツール

トークン操作

• deployToken：新しい ERC20 トークンコントラクトをデプロイする

  • コントラクトアドレスとトランザクションハッシュを返します

• transferETH：指定したアドレスに ETH を送金する

  • パラメーター：
    • targetAddress：ETH の受取先アドレス
    • amount：送金する ETH の量（1 = 1 ETH）
  • トランザクションハッシュを返します

• transferToken：指定したアドレスにトークンを送金する

  • パラメーター：
    • tokenAddress：デプロイ済み ERC20 トークンコントラクトのアドレス
    • targetAddress：トークンの受取先アドレス
  • トランザクションハッシュを返します

• batchTransfer：ランダムなアドレスへ一括送金を実行する

  • パラメーター：
    • tokenAddress：デプロイ済み ERC20 トークンコントラクトのアドレス
    • transactionCount：実行するトランザクション数
    • durationSeconds：一括処理にかける合計時間（秒）
  • 指定された時間内に、指定された数のトランザクションを実行します。

ネットワークサポート

このサーバーは、次のような Ethereum 互換ネットワークで動作するように設定されています。

• Ethereum Mainnet
• レイヤー 2 ネットワーク（Optimism、Arbitrum など）
• ローカル開発ネットワーク（Hardhat、Ganache）

ETH_L2_RPC 環境変数に適切な RPC URL を設定して、ネットワークを構成します。

開発

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Start the server
npm start

コントリビューション

GitHub での Issue とプルリクエストを歓迎します。

ライセンス

このプロジェクトは ISC License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。