ENS MCP Server

用于以太坊名称服务 (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

1. 安装依赖项：

npm i

1. 配置以太坊提供者：
   在项目根目录下创建一个.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桌面版一起使用

在你的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 文件。