Ens MCP

🚀 ENS MCP 服務器

ENS MCP 服務器是一個用於解析、分析和關聯 ENS 域名活動的 MCP 服務器，它能為 Web3 代理提供易讀的身份洞察信息。

✨ 主要特性

• 解析 ENS 名稱：將 ENS 域名（如 vitalik.eth）映射到以太坊地址。
• 詳細的域名信息：獲取全面的域名數據，包括地址、所有者、註冊者、過期時間、註冊信息、包裝域名和解析器詳情。
• 域名事件歷史：檢索諸如轉移、解析器更改和名稱包裝等事件，並提供相關地址和時間戳。

📦 安裝指南

安裝要求

• Python 3.10 或更高版本
• uv（推薦用於依賴管理）
• 有效的 The Graph API 密鑰

安裝步驟

1. 克隆倉庫：

git clone https://github.com/kukapay/ens-mcp.git
cd ens-mcp

2. 安裝依賴：

uv sync

3. 安裝到 Claude 桌面應用： 將服務器作為 Claude 桌面應用程序安裝：

uv run mcp install main.py --name "ens-mcp"

參考配置文件如下：

{
   "mcpServers": {
       "ens-mcp": {
           "command": "uv",
           "args": [ "--directory", "/path/to/ens-mcp", "run", "main.py" ],
           "env": { "THEGRAPH_API_KEY": "the_graph_api_key"}               
       }
   }
}

請將 /path/to/ens-mcp 替換為實際安裝路徑，將 the_graph_api_key 替換為你從 The Graph 獲取的 API 密鑰。

💻 使用示例

工具說明

服務器提供了三個 MCP 工具：

1. resolve_ens_name(domain: str) -> str 將 ENS 域名解析為其對應的以太坊地址。

• 輸入：ENS 域名（如 vitalik.eth）
• 輸出：以太坊地址（如 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045）或 "None"

示例：

resolve_ens_name("vitalik.eth") -> "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

2. get_domain_details(domain: str) -> str 獲取 ENS 域名的詳細信息，包括其地址。

• 輸入：ENS 域名
• 輸出：包含域名詳細信息（地址、所有者、註冊者、過期時間等）的格式化字符串

示例輸出：

ENS 域名: vitalik.eth
地址: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
標籤名稱: vitalik
標籤哈希: 0x...
子域名數量: 5
所有者: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
註冊者: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
包裝所有者: None
過期日期: 2025-10-31 00:00:00
TTL: 0 秒
是否遷移: true
創建時間: 2017-05-04 12:00:00
註冊信息: 註冊日期: 2017-05-04 12:00:00
註冊過期時間: 2025-10-31 00:00:00
註冊成本: 1000000000000000 Wei
註冊者: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
包裝域名: 未包裝
解析器: 解析器地址: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
內容哈希: None
文本記錄: email, url

3. get_domain_events(domain: str) -> str 檢索與 ENS 域名相關的事件。

• 輸入：ENS 域名
• 輸出：列出事件（如轉移、解析器更改）的格式化字符串

示例輸出：

事件: 轉移
區塊編號: 1234567
交易 ID: 0x...
新所有者: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

事件: 新解析器
區塊編號: 1234568
交易 ID: 0x...
解析器地址: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
解析器地址: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE 文件。