Back to MCP directory
publicPublicdnsLocal runtime

layer2-mcp

一个基于Model Context Protocol的以太坊Layer2网络交互服务器,为AI模型提供标准化接口,支持代币部署、交易管理和跨链操作。

article

README

🚀 层2 MCP 服务器

层2 MCP 服务器可用于与以太坊第二层网络进行交互。它具备多种实用功能,如部署 ERC20 代币、转移 ETH 和代币,还支持批量转移操作,能有效满足开发者在以太坊二层网络的多样化需求。

🚀 快速开始

层2 MCP 服务器为开发者提供了与以太坊第二层网络交互的便捷途径,以下将详细展示如何进行安装和使用。

📦 安装指南

# 克隆仓库
git clone https://github.com/anylots/layer2-mcp.git
cd layer2-mcp

# 安装依赖项
npm install

# 构建项目
npm run build

💻 使用示例

配置

在根目录下创建一个 .env 文件,并添加以下变量:

PRIVATE_KEY=你的以太坊私钥
ETH_L2_RPC=你要交互的第二层链 RPC 地址

与 Cursor 结合使用

在 Cursor 的 MCP 设置面板中添加命令类型 mcp server,并在执行命令中填写路径。例如:

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": "<<你的以太坊钱包私钥>>",
         "ETH_L2_RPC": "<<你要交互的第二层链 RPC 地址>>"
       }
     }
    
  3. 现在工具已经在 Claude 对话中可用。

测试

使用 MCP 检查器进行测试:

  1. 安装 MCP 检查器:
    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:总持续时间(秒)
    • 返回批量转移的结果。

网络支持

层2 MCP 服务器支持多种以太坊网络,包括主网、第二层网络和本地开发网络。通过设置环境变量 ETH_L2_RPC 可以指定要交互的链的 RPC 地址。

🔧 技术细节

开发

# 安装依赖项
npm install

# 运行开发模式
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start

🤝 贡献

该项目欢迎社区贡献。请参考 贡献指南 了解如何参与。

📄 许可证

该项目使用 MIT 许可证


此文档详细介绍了层2 MCP 服务器的使用和配置方法,助力开发者轻松集成和管理以太坊第二层网络交互功能。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client