使用说明

项目简介

EVM MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为 AI Agent 提供便捷的区块链服务。它支持连接到 30 多个 EVM 兼容的网络，例如 Ethereum、Optimism、Arbitrum、Base、Polygon 等，并提供统一的接口来访问区块链数据和执行操作。通过这个服务器，AI Agent 可以轻松地查询链上信息、与智能合约交互、进行代币交易等。

主要功能点

多链支持: 覆盖 30+ EVM 兼容网络，包括主网和测试网。
区块链数据访问: 获取链信息、区块数据、交易详情、地址余额等。
代币服务: 支持 ERC20 代币（查询信息、余额、转账、授权）、NFT (ERC721) 和 ERC1155 多代币标准。
智能合约交互: 读取合约状态、调用合约方法（需要私钥签名）。
ENS域名解析: 所有接受地址参数的工具和服务都支持使用 ENS 域名。

安装步骤

克隆仓库

git clone https://github.com/lugondev/bsc-testnet-mcp-servers.git
cd bsc-testnet-mcp-servers

安装依赖 推荐使用 Bun (如果已安装 Bun)：
```
bun install
```
或者使用 npm：
```
npm install
```

服务器配置

MCP 服务器旨在与 MCP 客户端协同工作。您需要在 MCP 客户端中配置服务器连接信息。以下是常用的 MCP 客户端配置示例，以 JSON 格式提供，您需要将这些配置添加到您的 MCP 客户端设置中。

Cursor 配置 (command 模式)

如果您使用 Cursor 编辑器，可以将 EVM MCP Server 配置为 command 模式，让 Cursor 通过命令行启动和连接服务器。

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

server name: 'evm-mcp-server' 或 'evm-mcp-http' - 服务器的名称，您可以自定义。
type: 'command' - 指定连接类型为命令行模式。
command: 'npx' - 使用 npx 命令来执行。
args:
- '"-y"' - (可选) - 用于跳过 npx 的安装确认提示。
- '"@mcpdotdirect/evm-mcp-server"' - 运行 stdio 模式的 MCP 服务器。
- '"--http"' - (仅 'evm-mcp-http' 配置需要) - 运行 HTTP 模式的 MCP 服务器。

Cursor 配置 (HTTP SSE 模式)

如果您希望使用 HTTP SSE 模式连接，首先需要启动 HTTP 服务器，然后在 Cursor 中配置 URL 连接。

1. 启动 HTTP 服务器

在仓库目录下，运行以下命令启动 HTTP 服务器：

bun start:http

2. 配置 Cursor

在 Cursor 的 MCP 服务器设置中，添加以下配置：

{
  "mcpServers": {
    "evm-mcp-sse": {
      "url": "http://localhost:3001/sse"
    }
  }
}

server name: 'evm-mcp-sse' - 服务器的名称，您可以自定义。
type: 默认为 'url'，或者您可以显式指定 '"type": "url"'。
url: '"http://localhost:3001/sse"' - HTTP SSE 服务器的 URL 地址。请确保服务器已在运行，并且地址正确。

基本使用方法

启动服务器: 根据您的 MCP 客户端配置选择合适的启动命令，例如 'bun start' (stdio 模式) 或 'bun start:http' (HTTP 模式)。
连接客户端: 在您的 MCP 客户端（如 Cursor）中启用并连接到配置好的 EVM MCP Server。
使用工具和资源: 在客户端中，您可以使用服务器提供的各种工具（Tools）和资源（Resources）来与 EVM 区块链网络进行交互。例如，您可以查询地址余额、获取交易信息、调用智能合约等。详细的 API 参考请查阅仓库的 'README.md' 文件。

提示

私钥安全: 服务器使用私钥进行交易签名，请务必安全管理您的私钥。
网络选择: 根据您的需求选择合适的 EVM 网络。服务器支持众多主网和测试网，默认使用 Ethereum 主网。
API 参考: 'README.md' 文件中提供了详细的 API 参考，包括可用的工具和资源 URI，方便您在 MCP 客户端中使用。

关键词

使用说明

信息