🚀 ENS MCP 服务器
ENS MCP 服务器是一个用于解析、分析和关联 ENS 域名活动的 MCP 服务器，它能为 Web3 代理提供易读的身份洞察信息。
✨ 主要特性
- 解析 ENS 名称：将 ENS 域名（如
vitalik.eth）映射到以太坊地址。 - 详细的域名信息：获取全面的域名数据，包括地址、所有者、注册者、过期时间、注册信息、包装域名和解析器详情。
- 域名事件历史：检索诸如转移、解析器更改和名称包装等事件，并提供相关地址和时间戳。
📦 安装指南
安装要求
- Python 3.10 或更高版本
- uv（推荐用于依赖管理）
- 有效的 The Graph API 密钥
安装步骤
- 克隆仓库：
git clone https://github.com/kukapay/ens-mcp.git
cd ens-mcp
- 安装依赖：
uv sync
- 安装到 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 工具：
- resolve_ens_name(domain: str) -> str 将 ENS 域名解析为其对应的以太坊地址。
- 输入：ENS 域名（如
vitalik.eth） - 输出：以太坊地址（如
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045）或 "None"
示例：
resolve_ens_name("vitalik.eth") -> "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
- 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
- get_domain_events(domain: str) -> str 检索与 ENS 域名相关的事件。
- 输入：ENS 域名
- 输出：列出事件（如转移、解析器更改）的格式化字符串
示例输出：
事件: 转移
区块编号: 1234567
交易 ID: 0x...
新所有者: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
事件: 新解析器
区块编号: 1234568
交易 ID: 0x...
解析器地址: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
解析器地址: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
📄 许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。