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文件。