EVM MCP 服务器

这是一个基于VS Code模型上下文协议（MCP）的服务器，使AI代理能够访问并交互EVM区块链数据。

概述

该服务器实现了模型上下文协议，为AI助手提供实时访问以太坊和其他兼容EVM的区块链网络的能力。通过与VS Code的MCP基础设施集成，该服务器允许AI代理查询区块链数据、检查账户余额、识别智能合约以及监控多个支持网络的Gas价格。

特性

• 多链支持：访问以太坊、Base、Arbitrum、Avalanche和币安智能链的数据
• 余额查询：检查任何地址的原生代币余额
• 合约检测：确定一个地址是否是智能合约或外部拥有账户（EOA）
• Gas价格监控：获取支持链上的当前Gas价格
• MCP合规性：使用官方模型上下文协议SDK构建

预备条件

• Node.js 18.x 或更高版本
• QuickNode API 访问权限
• 支持MCP的VS Code

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   # 或者
   pnpm install
   

3. 设置环境变量（参见配置部分）
4. 构建项目：

   npm run build
   # 或者
   pnpm build
   

5. 启动服务器：

   npm start
   # 或者
   pnpm start
   

配置

在根目录创建一个.env文件，并包含以下变量：

# QuickNode API 配置
QN_ENDPOINT_NAME=your-quicknode-endpoint
QN_TOKEN_ID=your-quicknode-token-id

# 可选：替代RPC端点
# ETHEREUM_RPC=https://your-ethereum-rpc-url
# BASE_RPC=https://your-base-rpc-url
# ARBITRUM_RPC=https://your-arbitrum-rpc-url
# AVALANCHE_RPC=https://your-avalanche-rpc-url
# BSC_RPC=https://your-bsc-rpc-url

API 配置

服务器需要访问区块链RPC端点。默认情况下，它使用QuickNode作为RPC提供商。你需要：

1. 注册一个QuickNode账户
2. 为每个你想支持的区块链创建端点
3. 将你的端点名称和令牌ID添加到环境变量中

或者，你可以通过配置.env文件中的可选RPC端点变量来使用其他任何RPC提供商。

可用工具

eth_getBalance

检索地址的原生代币余额。

{
  "address": "0x...", // 有效的以太坊地址
  "chain": "ethereum" // 之一：ethereum, base, arbitrum, avalanche, bsc
}

eth_getCode

确定一个地址是否是合约或钱包。

{
  1. "address": "0x...", // 有效的以太坊地址
  2. "chain": "ethereum" // 之一：ethereum, base, arbitrum, avalanche, bsc
}

eth_gasPrice

获取指定链上的当前Gas价格。

{
  "chain": "ethereum" // 之一：ethereum, base, arbitrum, avalanche, bsc
}

与VS Code的集成

此服务器旨在与VS Code的模型上下文协议扩展一起使用。当正确配置时，VS Code的AI助手可以通过自然语言查询直接访问区块链数据。

许可证

ISC

贡献

欢迎贡献！请随意提交拉取请求。