EVM Blockchain

🚀 EVM 服务器

本项目是 EVM（Ethereum 虚拟机）服务器，支持多种区块链网络，提供丰富的资源接口和工具，可用于查询区块链数据、进行代币交互、操作智能合约等。

🚀 快速开始

开发步骤

1. 安装依赖：npm install
2. 启动服务器：npm run dev
3. 调试工具：使用 ts-node 进行模块调试

配置文件

• config/chains.ts：定义支持的区块链网络配置。
• config/secrets.ts：存储敏感信息，如 API 密钥。

✨ 主要特性

• 区块链数据：支持查询多个区块链网络的链信息、区块数据、交易记录等。
• 代币交互：支持 ERC20、ERC721 和 ERC1155 代币的余额查询、转账等功能。
• 智能合约：提供读取和写入智能合约的能力，支持 ABI 接口调用。
• ENS 解析：支持将 ENS 名称解析为地址。
• 工具与资源：提供了多种区块链开发工具和资源接口。

📦 安装指南

1. 安装依赖：npm install
2. 启动服务器：npm run dev

📚 详细文档

项目结构

mcp-evm-server/
├── src/
│   ├── index.ts                # 主标准输入输出服务器入口文件
│   ├── server/                 # 服务器相关文件
│   │   ├── http-server.ts      # 带 SSE 的 HTTP 服务器实现
│   │   └── server.ts           # 通用服务器设置
│   ├── core/
│   │   ├── chains.ts           # 链定义和工具函数
│   │   ├── resources.ts        # MCP 资源实现
│   │   ├── tools.ts            # MCP 工具实现
│   │   ├── prompts.ts          # MCP 提示实现
│   │   └── services/           # 核心区块链服务
│   │       ├── index.ts        # 操作导出
│   │       ├── balance.ts      # 平衡服务
│   │       ├── transfer.ts     # 代币转移服务
│   │       ├── utils.ts        # 工具函数
│   │       ├── tokens.ts       # 代币元数据服务
│   │       ├── contracts.ts    # 合约交互服务
│   │       ├── transactions.ts # 交易服务
│   │       └── blocks.ts       # 区块服务
│   │       └── clients.ts      # RPC 客户端工具
├── package.json
├── tsconfig.json
└── README.md

资源接口

区块链资源 URI 模式

代币资源 URI 模式

工具实现

核心工具类

• ChainManager：管理多个区块链网络的连接和配置。
• TxBuilder：交易构建器，支持多种链上操作。
• ContractCaller：智能合约调用工具，支持 ABI 接口。

代币工具类

• TokenBalanceQuery：用于查询代币余额。
• TokenTransfer：实现代币转账功能。
• NFTManager：管理 NFT 资产，支持 mint、burn 等操作。

安全注意事项

1. 私钥安全：所有私钥操作必须在可信环境中进行，禁止明文存储或传输。
2. 网络隔离：生产环境和测试环境应严格隔离，防止数据泄露。
3. 权限控制：对敏感操作实施严格的权限验证。
4. 监控审计：部署实时监控和审计系统，记录所有关键操作。

术语表

• EVM：Ethereum 虚拟机，运行智能合约的环境。
• ERC20：基于 Ethereum 的代币标准。
• ERC721：NFT 标准协议。
• ERC1155：多令牌标准协议。
• SSE：服务器端事件，用于实时通信。

📄 许可证

本项目遵循 MIT 协议。