🚀 EVM 服务器
EVM（Ethereum Virtual Machine）服务器是基于 MCP 协议的扩展工具，可与以太坊区块链交互。它支持智能合约操作、代币管理、交易处理等多种功能，为区块链应用开发提供便利。
🚀 快速开始
EVM 服务器使用简单，按以下步骤操作即可开启服务：
- 安装依赖：使用
npm安装所需依赖。
npm install
- 启动服务器：运行主程序启动服务器。
npm start
✨ 主要特性
核心功能
- 智能合约操作：支持读取和写入智能合约状态，方便开发者对合约进行灵活操作。
- 代币管理：提供对 ERC20、ERC721 和 ERC1155 代币的全面支持，满足不同代币类型的管理需求。
- 交易处理：允许发送和接收以太坊原生代币及各种代币，实现便捷的资金流转。
高级功能
- 区块查询：可获取指定区块或最新区块的数据，便于开发者进行数据统计和分析。
- 日志记录：提供详细的交易 receipt 和事件日志，帮助开发者快速定位问题。
- 网络支持：支持多个区块链网络，如 Ethereum、Binance Smart Chain 等，扩大了应用的适用范围。
📦 安装指南
安装依赖
使用 npm 安装所需依赖：
npm install
启动服务器
运行主程序启动服务器：
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' }
}
};
📚 详细文档
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 和认证机制，防止非法访问。
- 日志监控：实时监控服务器日志，及时发现异常并采取措施。
开发说明
贡献指南
欢迎社区贡献代码！请遵循以下步骤：
- Fork 项目仓库。
- 创建功能分支。
- 提交代码并创建 Pull Request。
问题反馈
遇到问题请联系维护团队：contact@evm-server.com
📄 许可证
本项目遵循 MIT 协议。详情请查看 LICENSE 文件。