🚀 以太坊名称服务 (ENS) MCP 服务器
本项目为以太坊名称服务 (ENS) 提供 MCP 服务器，助力 Claude 与 ENS 系统实现交互。借助该服务器，可轻松实现域名解析、检查名称可用性、检索记录等功能。
npm 包：https://www.npmjs.com/package/mcp-server-ens
🚀 快速开始
本服务器为Claude与ENS系统搭建了交互桥梁，你可利用其提供的工具实现各类ENS相关操作。
✨ 主要特性
- 支持将 ENS 名称解析为以太坊地址。
- 能根据以太坊地址反向查找对应的 ENS 名称。
- 可获取指定 ENS 名称特定键值对的文本记录。
- 能检查 ENS 名称是否可注册。
- 可获取指定 ENS 名称的所有相关信息。
- 能获取指定 ENS 名称的所有子域名。
- 可查看指定 ENS 名称的历史记录。
💻 使用示例
基础用法
以下是使用该服务器工具的基本代码示例：
# 示例代码需要根据实际的调用方式和语言进行编写，这里仅为示意
# 解析名称
result = resolve_name('vitalik.eth')
print(result)
# 反向查找
result = reverse_lookup('0x1234567890abcdef...')
print(result)
# 获取文本记录
result = get_text_record('vitalik.eth', 'email')
print(result)
# 检查可用性
result = check_availability('new_name.eth')
print(result)
# 获取所有记录
result = get_all_records('vitalik.eth')
print(result)
# 获取子域名
result = get_subdomains('vitalik.eth')
print(result)
# 获取名称历史
result = get_name_history('vitalik.eth')
print(result)
高级用法
在实际应用中，你可以结合错误处理和循环等逻辑，实现更复杂的操作：
# 批量解析名称
names = ['vitalik.eth', 'example.eth']
for name in names:
try:
result = resolve_name(name)
print(f'{name} 解析结果: {result}')
except Exception as e:
print(f'{name} 解析出错: {e}')
📚 详细文档
解析名称
将 ENS 名称解析为以太坊地址。
- 所需输入：
name(字符串)：要解析的 ENS 名称（例如 'vitalik.eth'）
- 返回结果：对应的以太坊地址或错误信息
反向查找
根据以太坊地址获取 ENS 名称。
- 所需输入：
address(字符串)：要查询的以太坊地址
- 返回结果：对应的 ENS 名称或未找到名称的提示
获取文本记录
为指定的 ENS 名称获取特定键值对的文本记录。
- 所需输入：
name(字符串)：要查询的 ENS 名称key(字符串)：要查找的记录密钥（例如 'email'、'url'、'avatar'、'description'、'twitter' 等）
- 返回结果：指定密钥对应的值或未找到记录的提示
检查可用性
检查 ENS 名称是否可注册。
- 所需输入：
name(字符串)：要检查的 ENS 名称
- 返回结果：可用性状态及注册信息（如果已注册）
获取所有记录
获取指定 ENS 名称的所有相关信息。
- 所需输入：
name(字符串)：要查询的 ENS 名称
- 返回结果：包含解析器地址、文本记录、地址、内容哈希、所有权及过期信息的详细信息
获取子域名
获取指定 ENS 名称的所有子域名。
- 所需输入：
name(字符串)：要查询子域名的 ENS 名称
- 返回结果：子域名列表及其所有者信息
获取名称历史
查看指定 ENS 名称的历史记录。
- 所需输入：
name(字符串)：要检查历史记录的 ENS 名称
- 返回结果：与该名称相关的历史信息