Crazyrabbitltc MCP Etherscan Server

🚀 以太坊Etherscan MCP服務器

本項目是一個基於MCP（模型上下文協議）的服務器，藉助Etherscan API，為用戶提供豐富的以太坊區塊鏈數據查詢工具。用戶可以通過它檢查ETH餘額、查看交易歷史記錄、跟蹤ERC20代幣轉賬、獲取智能合約ABI、監控氣體價格以及解析ENS名稱，極大地提升了以太坊數據交互的便利性。

🚀 快速開始

本服務器實現模型上下文協議（MCP），通過Etherscan的API提供以太坊區塊鏈數據交互工具。每個工具作為MCP端點進行暴露，可由兼容的客戶端調用。

先決條件

• Node.js >= 18
• Etherscan API密鑰（可在https://etherscan.io/apis獲取）

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

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

ETHERSCAN_API_KEY=你的API密鑰

4. 構建項目：

npm run build

運行服務器

啟動服務器：

npm start

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

✨ 主要特性

• 餘額查詢：可獲取任意以太坊地址的ETH餘額。
• 交易歷史：能查看帶有詳細信息的最近交易。
• 代幣轉賬：可追蹤ERC20代幣的轉賬記錄及其代幣詳情。
• 合約ABI：能獲取智能合約的ABI，滿足開發需求。
• 氣體價格：可監控當前的氣體價格（安全低、標準、快速）。
• ENS解析：可將以太坊地址解析為ENS名稱。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

配置環境變量

在根目錄創建一個.env文件，並填入Etherscan API密鑰：

ETHERSCAN_API_KEY=你的API密鑰

構建項目

npm run build

💻 使用示例

基礎用法

使用Claude Desktop調用服務器工具示例：

檢查0x742d35Cc6634C0532925a3b844Bc454e4438f44e的餘額
或
顯示vitalik.eth的近期交易記錄

高級用法

與Claude Desktop集成

將此服務器添加到Claude Desktop：

1. 使用npm start啟動服務器。
2. 在Claude Desktop中：
   • 轉到設置
   • 進入MCP服務器部分
   • 點擊“添加服務器”
   • 輸入以下配置：

     {
       "name": "Etherscan工具",
       "transport": "stdio",
       "command": "node /path/to/mcp-etherscan-server/build/index.js"
     }
     

   • 保存配置
3. 現在，Etherscan工具將在Claude對話中可用。

📚 詳細文檔

可用工具

1. check-balance

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

2. get-transactions

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

3. get-token-transfers

   • 輸入：以太坊地址、可選限制
   • 輸出：近期ERC20代幣轉賬記錄及其詳細信息

4. get-contract-abi

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

5. get-gas-prices

   • 輸入：無
   • 輸出：當前氣體價格（單位為Gwei）

6. get-ens-name

   • 輸入：以太坊地址
   • 輸出：可用時解析出的ENS名稱

🔧 技術細節

開發邏輯

• 主服務器邏輯在src/server.ts。
• Etherscan API交互處理在src/services/etherscanService.ts。

修改與構建

若要添加新功能或修改現有功能，修改相關代碼後，使用npm run build進行構建。

📄 許可證

本項目採用MIT License，詳情請查看LICENSE文件。