ens-mcp-server

🚀 ENS MCP 服务器

本项目是为以太坊名称服务（ENS）设计的MCP服务器，它能让Claude与ENS系统进行交互，实现域名解析、检查可用性、检索记录等功能。

npm 包：https://www.npmjs.com/package/mcp-server-ens

🚀 快速开始

本ENS MCP服务器可助力Claude与ENS系统交互，实现多种ENS相关功能。下面将详细介绍其使用方法。

✨ 主要特性

解析名称

将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名称
• 返回：名称的所有历史记录

获取价格

获取ENS名称的当前价格（以太坊）。

• 所需输入：
  • name（字符串）：需查询价格的ENS名称
• 返回：名称的当前价格（以太坊）

📦 安装指南

先决条件

1. 确保安装了Node.js和npm。
2. 安装必要的依赖项：@ensdomains/mcp-server、@ensdomains/eth-typings 和 @ensdomains/resolver。

安装

使用以下命令安装MCP服务器：

npm install -g @ensdomains/mcp-server

配置提供者URL

通过PROVIDER_URL环境变量指定以太坊节点的RPC端点。支持多个提供者，只需用逗号分隔URL即可。例如：

export PROVIDER_URL="https://eth-mainnet.g.alchemy.com/v1/YOUR_API_KEY,https://eth-mainnet.rpcool.com"

💻 使用示例

在Claude Desktop上的使用

使用npx启动MCP服务器

在终端中运行以下命令：

npx @ensdomains/mcp-server --config ./path/to/config.json

使用本地脚本启动MCP服务器

1. 创建一个配置文件server.js，内容如下：

const { startServer } = require('@ensdomains/mcp-server');  
startServer({  
  configPath: './config.json',  
});

2. 在终端中运行：

node server.js

📚 详细文档

错误处理

• 如果出现错误，请检查以下内容：
  • 确保ENS名称格式正确。
  • 尝试使用多个提供者，通过在PROVIDER_URL环境变量中逗号分隔多个URL。
  • 确保已安装最新版本的ENS库。

发布说明

此MCP服务器遵循语义化版本控制。发布说明将在CHANGELOG.md文件中提供。

📄 许可证

此MCP服务器根据MIT许可证分发。这意味着您可以自由使用、修改和分发软件，但需遵守MIT许可证的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。