MCP Etherscan Server

🚀 MCP 以太坊瀏覽器服務器

MCP 以太坊瀏覽器服務器基於 Model Context Protocol (MCP)，藉助 Etherscan 的 API，為用戶提供豐富的以太坊區塊鏈數據工具。它可以幫助用戶檢查 ETH 餘額、查看交易歷史、追蹤 ERC20 轉賬、獲取智能合約 ABI、監控氣體價格以及解析 ENS 名稱，極大地提升了用戶與以太坊區塊鏈交互的便利性。

✨ 主要特性

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

📦 安裝指南

先決條件

• 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=your_api_key_here

4. 構建項目：

npm run build

🚀 快速開始

啟動服務器

運行以下命令啟動服務器：

npm start

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

💻 使用示例

可用工具

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": "Etherscan 工具",
    "transport": "stdio",
    "command": "node /path/to/mcp-etherscan-server/build/index.js"
}

- 保存配置。

3. 現在，Etherscan 工具將在 Claude 對話中可用。

示例用法

在 Claude 中可以使用如下命令：

檢查 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的餘額

或

顯示 vitalik.eth 的最近交易記錄

🔧 技術細節

該服務器實現了 Model Context Protocol (MCP)，通過 Etherscan 的 API 提供以太坊區塊鏈數據工具。每個工具作為 MCP 端點暴露出來，可被兼容客戶端調用。

📚 詳細文檔

開發

若要添加新功能或修改現有功能，可按以下步驟操作：

1. 主服務器邏輯位於 src/server.ts。
2. Etherscan API 交互處理在 src/services/etherscanService.ts。
3. 修改後進行構建：

npm run build

📄 許可證

[在此處添加許可證信息，例如 MIT 或 GPL]

通過此 MCP 以太坊瀏覽器服務器，您可以方便地集成和管理以太坊區塊鏈數據，適用於開發人員、研究人員及區塊鏈愛好者。