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 文件。