Etherscan Tools

🚀 MCP 以太坊瀏覽器服務器

MCP 以太坊瀏覽器服務器基於模型上下文協議（Model Context Protocol）構建，藉助以太坊瀏覽器 API 提供豐富的以太坊區塊鏈數據工具。它能幫助用戶檢查 ETH 餘額、查看交易記錄、跟蹤 ERC20 轉賬等，為區塊鏈數據交互提供便利。

🚀 快速開始

先決條件

• Node.js >= 18
• 一個以太坊瀏覽器 API 密鑰（獲取方式：https://etherscan.io/apis）

安裝

1. 克隆倉庫：

git clone [your-repo-url]
cd mcp-etherscan-server

2. 安裝依賴項：

npm install

3. 在根目錄下創建一個 .env 文件：

ETHERSCAN_API_KEY=your_api_key_here

4. 構建項目：

npm run build

運行服務器

啟動服務器：

npm start

服務器將在標準輸入輸出上運行，使其與 MCP 客戶端（如 Claude Desktop）兼容。

✨ 主要特性

• 餘額查詢：獲取任意以太坊地址的 ETH 餘額
• 交易記錄：查看最近的交易記錄及詳細信息
• 代幣轉賬：追蹤 ERC20 代幣的轉賬記錄及其代幣詳情
• 合約 ABI：獲取智能合約的 ABI（應用二進制接口）用於開發
• 汽油價格監控：查看當前的汽油價格（安全低、標準、快速）
• ENS 解析：將以太坊地址解析為 ENS 名稱

🔧 技術細節

工作原理

該服務器實現模型上下文協議（MCP），通過以太坊瀏覽器 API 提供工具以交互區塊鏈數據。每個工具都作為一個 MCP 終端點，可供兼容客戶端調用。

可用工具

1. check-balance

   • 輸入：以太坊地址
   • 輸出：ETH 餘額（Wei 和 ETH）

2. get-transactions

   • 輸入：以太坊地址、可選限制
   • 輸出：最近的交易記錄，包括時間戳、價值和地址

3. get-token-transfers

   • 輸入：以太坊地址、可選限制
   • 輸出：最近的 ERC20 代幣轉賬記錄及其代幣詳情

4. get-contract-abi

   • 輸入：合約地址
   • 輸出：合約 ABI 的 JSON 格式

5. get-gas-prices

   • 輸入：無
   • 輸出：當前汽油價格（Gwei）

6. get-ens-name

   • 輸入：以太坊地址
   • 輸出：可用的關聯 ENS 名稱

💻 使用示例

與 Claude Desktop 集成

要將此服務器添加到 Claude Desktop：

1. 使用 npm start 啟動服務器

2. 在 Claude Desktop 中：

   • 打開設置
   • 進入 MCP 服務器部分
   • 點擊“添加服務器”
   • 輸入以下配置：

     {
       "name": "以太坊瀏覽器工具",
       "transport": "stdio"
     }