返回 MCP 目录
public公开dns本地运行

Ethereum Name Service (ENS)

ENS MCP服务器是一个用于与以太坊域名系统交互的工具,提供域名解析、记录查询等功能。

article

README

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端