返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端