Information
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提供者（公共或私有）
安装
克隆仓库或创建新项目：
git clone https://github.com/JustaName-id/ens-mcp-server
安装依赖项：
npm i
配置以太坊提供者：
在项目根目录下创建一个.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 文件。