🚀 EVM 服务器

EVM（Ethereum Virtual Machine）服务器是基于 MCP 协议的扩展工具，可与以太坊区块链交互。它支持智能合约操作、代币管理、交易处理等多种功能，为区块链应用开发提供便利。

🚀 快速开始

EVM 服务器能帮助你轻松与以太坊区块链交互。按以下步骤操作，即可快速搭建并启动服务器。

安装依赖

使用 npm 安装所需依赖：

npm install

启动服务器

运行主程序启动服务器：

npm start

📦 安装指南

安装依赖

使用 npm 来安装项目所需的依赖：

npm install

启动服务器

通过运行主程序来启动 EVM 服务器：

npm start

💻 使用示例

基础用法

以下是一个典型的服务器配置示例：

const config = {
  port: 3000,
  networks: ['eth', 'bsc'],
  chains: {
    eth: { providerUrl: 'https://mainnet.infura.io/v3/YOUR_API_KEY' },
    bsc: { providerUrl: 'https://bsc-dataseed1.binance.org' }
  }
};

✨ 主要特性

核心功能

• 智能合约操作：可读取和写入智能合约状态，为合约开发和交互提供基础支持。
• 代币管理：全面支持 ERC20、ERC721 和 ERC1155 代币，满足不同代币类型的管理需求。
• 交易处理：允许发送和接收以太坊原生代币及各种代币，实现便捷的资产转移。

高级功能

• 区块查询：能获取指定区块或最新区块的数据，方便开发者进行区块链数据的分析和监控。
• 日志记录：提供详细的交易 receipt 和事件日志，有助于追踪交易过程和排查问题。
• 网络支持：支持多个区块链网络，如 Ethereum、Binance Smart Chain 等，扩大了应用的适用范围。

📚 详细文档

API 文档

请求格式

所有请求均采用 JSON 格式：

{
  "method": "eth_getBalance",
  "params": ["0x1234567890123456789012345678901234567890", "latest"],
  "id": 1,
  "jsonrpc": "2.0"
}

响应格式

{
  "jsonrpc": "2.0",
  "result": "0x123",
  "error": null,
  "id": 1
}

项目结构

以下是项目的目录结构：

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 提示实现
│   │   └── utils/              # 辅助工具函数
│   │       └── abi_decoder.ts  # ABI 解码器
└── package.json               # 项目依赖和脚本

🔧 技术细节

安全考虑

• 网络隔离：确保生产环境与开发环境分开，防止开发过程中的错误影响到生产环境。
• 访问控制：配置合适的 CORS 和认证机制，保障服务器的访问安全。
• 日志监控：实时监控服务器日志，及时发现异常情况并进行处理。

开发说明

贡献指南

欢迎社区贡献代码！请遵循以下步骤：

1. Fork 项目仓库。
2. 创建功能分支。
3. 提交代码并创建 Pull Request。

问题反馈

遇到问题请联系维护团队：contact@evm-server.com

📄 许可证

本项目遵循 MIT 协议。详情请查看 LICENSE 文件。