ENS MCP 服务器

用于以太坊域名服务 (ENS) 的 MCP 服务器，使 Claude 能够与 ENS 系统交互，以解析名称、检查可用性、检索记录等。

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

工具

resolve-name

将 ENS 名称解析为以太坊地址

• 必需输入：
  • name (字符串)：要解析的 ENS 名称（例如，“vitalik.eth”）
• 返回： 相应的以太坊地址或错误消息

reverse-lookup

获取以太坊地址的 ENS 名称

• 必需输入：
  • address (字符串)：要查找的以太坊地址
• 返回： 相应的 ENS 名称或未找到名称的指示

get-text-record

获取 ENS 名称的文本记录

• 必需输入：
  • name (字符串)：要查询的 ENS 名称
  • key (字符串)：要查找的记录键（例如，“email”、“url”、“avatar”、“description”、“twitter”等）
• 返回： 指定文本记录的值或未找到记录的指示

check-availability

检查 ENS 名称是否可用于注册

• 必需输入：
  • name (字符串)：要检查的 ENS 名称
• 返回： 可用性状态和所有者信息（如果已注册）

get-all-records

获取 ENS 名称的所有可用信息

• 必需输入：
  • name (字符串)：要查询的 ENS 名称
• 返回： 综合信息，包括解析器地址、文本记录、地址、内容哈希、所有权和到期详细信息

get-subdomains

获取 ENS 名称的子域名

• 必需输入：
  • name (字符串)：要查询子域名的 ENS 名称
• 返回： 子域名列表及其所有者信息

get-name-history

获取 ENS 名称的历史记录

• 必需输入：
  • name (字符串)：要检查历史记录的 ENS 名称
• 返回： 与该名称相关的历史事件，包括转移、解析器更改和注册事件

get-registration-price

获取注册 ENS 名称的价格

• 必需输入：
  • name (字符串)：要检查价格的 ENS 名称
• 可选输入：
  • duration (数字，默认值：1)：注册持续时间（年）
• 返回： 注册价格细分，包括基本价格、溢价和总价

设置

前提条件

• Node.js (v16 或更高版本)
• npm 或 yarn
• 访问以太坊 RPC 提供程序（公共或私有）

安装

1. 克隆存储库或创建一个新项目：

git clone https://github.com/JustaName-id/ens-mcp-server

2. 安装依赖项：

npm i

3. 配置以太坊提供程序： 在项目根目录中创建一个 .env 文件，其中包含以下内容（可选）：

PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.com

如果未指定任何提供程序，服务器将使用以下默认值：

• https://eth.drpc.org
• https://eth.llamarpc.com
• https://ethereum.publicnode.com
• https://rpc.ankr.com/eth

与 Claude Desktop 一起使用

将以下内容添加到您的 claude_desktop_config.json：

使用 npx

{
  "mcpServers": {
    "ens": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ens"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

使用本地脚本

{
  "mcpServers": {
    "ens": {
      "command": "node",
      "args": [
        "/path/to/your/server.js"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

错误处理

服务器为各种场景实现了强大的错误处理：

• 连接到以太坊提供程序的网络错误
• 无效的 ENS 名称或以太坊地址
• ENS 特定的错误
• 一般操作错误

所有错误都被规范化为用户友好的消息，同时保留技术细节以进行调试。

发布

要作为 npm 包发布：

npm publish --access public

故障排除

如果遇到错误：

• 验证您的以太坊提供程序是否工作且可访问
• 检查您查询的 ENS 名称的格式是否正确
• 确保您拥有最新版本的 ENS 库
• 尝试通过在 PROVIDER_URL 环境变量中使用逗号分隔它们来使用多个提供程序

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。