EVM区块链数据访问服务

一个基于VS Code Model Context Protocol (MCP)的服务器,使AI代理能够访问和交互EVM区块链数据,支持多链查询、余额检查、合约检测和gas价格监控。

  • by Adedejiosvaldo
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Adedejiosvaldo/etherum_mcp_vscode

使用说明

EVM MCP服务器

VS代码模型上下文协议(MCP)服务器,使AI代理能够访问EVM区块链数据并与之交互。

概述

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

特性

  • 多链支持:访问来自以太坊、Base、Arbitrum、Avalanche和币安智能链的数据
  • 余额查询:检查任何地址的本地令牌余额
  • 合同检测:确定地址是智能合约还是外部拥有的帐户(EOA)
  • 天然气价格监测:获取受支持区块链的当前天然气价格
  • MCP合规性:使用官方模型上下文协议SDK构建

先决条件

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

安装

  1. 克隆此存储库
  2. 安装依赖项:
    npm install
    # or
    pnpm install
    
  3. 设置环境变量(请参阅配置部分)
  4. 构建项目:
    npm run build
    # or
    pnpm build
    
  5. 启动服务器:
    npm start
    # or
    pnpm start
    

配置

创建一个 .env 根目录中的文件,包含以下变量:

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

# Optional: Alternative RPC endpoints
# 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 文件。

可用工具

eth_getBalance

检索地址的本机令牌余额。

{
  "address": "0x...", // Valid Ethereum address
  "chain": "ethereum" // One of: ethereum, base, arbitrum, avalanche, bsc
}

eth_getCode

确定地址是合约还是钱包。

{
  "address": "0x...", // Valid Ethereum address
  "chain": "ethereum" // One of: ethereum, base, arbitrum, avalanche, bsc
}

eth_gasPrice

获取指定链上的当前天然气价格。

{
  "chain": "ethereum" // One of: ethereum, base, arbitrum, avalanche, bsc
}

与VS代码集成

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

许可证

国际协调委员会

贡献

欢迎投稿!请随时提交拉取请求。