EVM MCP Server

EVM MCP Server

site icon
2025.04.02 188
TypeScript区块链服务多链支持智能合约交互代币管理金融服务
EVM MCP Server 是一个基于模型上下文协议(MCP)的区块链服务服务器,支持多种EVM兼容网络(如以太坊、Optimism、Arbitrum等)。它提供统一的接口,使AI代理能够读取区块链状态、与智能合约交互、转移代币等。该服务器支持30+ EVM网络,并集成了ENS名称解析功能,简化了区块链交互。
View on GitHub

Overview

基本能力

产品定位

EVM MCP Server 是一个为AI代理提供区块链服务的中间件,支持多种EVM兼容网络,简化区块链交互。

核心功能

  • 多链支持:支持30+ EVM兼容网络
  • 区块链数据访问:读取区块、交易、地址余额等
  • 代币服务:支持ERC20、ERC721、ERC1155代币的元数据查询、余额检查和转移
  • 智能合约交互:读取合约状态、写入合约、验证合约
  • ENS名称解析:支持使用ENS名称(如vitalik.eth)代替地址
  • 交易支持:原生代币转移、Gas估算、交易状态查询

适用场景

  • AI代理需要与区块链交互的场景
  • 多链DApp开发
  • 区块链数据分析
  • 代币管理和转移

工具列表

  • 代币服务工具get-token-info, get-token-balance, transfer-token, approve-token-spending, get-nft-info, check-nft-ownership, transfer-nft, get-nft-balance, get-erc1155-token-uri, get-erc1155-balance, transfer-erc1155
  • 区块链服务工具get-chain-info, get-balance, transfer-eth, get-transaction, read-contract, write-contract, is-contract, resolve-ens

常见问题解答

  • 安全性:私钥仅用于交易签名,不会被服务器存储
  • 网络支持:支持30+ EVM网络,包括主网和测试网
  • ENS支持:所有接受地址参数的接口都支持ENS名称

使用教程

使用依赖

  • Bun 1.0.0或更高版本
  • Node.js 18.0.0或更高版本(如果不使用Bun)

安装教程

# 克隆仓库
git clone https://github.com/mcpdotdirect/mcp-evm-server.git
cd mcp-evm-server

# 使用Bun安装依赖
bun install

# 或使用npm
npm install

调试方式

启动服务器

# 启动stdio服务器(用于CLI工具)
bun start

# 开发模式(自动重载)
bun dev

# 启动HTTP服务器(用于Web应用)
bun start:http

# HTTP开发模式(自动重载)
bun dev:http

使用npx直接运行

# 运行stdio模式服务器
npx @mcpdotdirect/evm-mcp-server

# 运行HTTP模式服务器
npx @mcpdotdirect/evm-mcp-server --http

连接到Cursor

  1. 在Cursor设置中添加MCP服务器
  2. 服务器名称:evm-mcp-server
  3. 类型:command
  4. 命令:npx @mcpdotdirect/evm-mcp-server
  5. 保存后即可在Cursor中使用

使用mcp.json配置

在项目根目录的.cursor/mcp.json文件中添加配置:

{
  "mcpServers": {
    "evm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpdotdirect/evm-mcp-server"
      ]
    },
    "evm-mcp-http": {
      "command": "npx",
      "args": [
        "-y", 
        "@mcpdotdirect/evm-mcp-server", 
        "--http"
      ]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。