🚀 以太坊名称服务 (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 名称
• 返回结果：与该名称相关的历史信息