ENS MCP Server
ENS MCP サーバー
Ethereum Name Service (ENS) 用の MCP サーバー。Claude が ENS システムと対話して名前を解決したり、可用性を確認したり、レコードを取得したりできるようになります。
npm パッケージ: https://www.npmjs.com/package/mcp-server-ens
ツール
名前解決
ENS名をEthereumアドレスに解決する
必要な入力:
name(文字列): 解決するENS名(例: 'vitalik.eth')
**戻り値:**対応するEthereumアドレスまたはエラーメッセージ
逆引き
EthereumアドレスのENS名を取得する
必要な入力:
address(文字列): 検索するEthereumアドレス
**戻り値:**対応する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名
オプション入力:
duration(数値、デフォルト:1):登録期間(年)
**返品:**登録価格の内訳(基本価格、プレミアム、合計)
Related MCP server: MCP Crypto Wallet EVM
設定
前提条件
Node.js (v16 以上)
npmまたはyarn
Ethereum RPC プロバイダーへのアクセス (パブリックまたはプライベート)
インストール
リポジトリをクローンするか、新しいプロジェクトを作成します。
git clone https://github.com/JustaName-id/ens-mcp-server依存関係をインストールします:
npm iEthereum プロバイダーを構成する: 次の内容を含む
.envファイルをプロジェクト ルートに作成します (オプション)。
PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.comプロバイダーが指定されていない場合、サーバーは次のデフォルトを使用します。
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"
}
}
}
}エラー処理
サーバーは、さまざまなシナリオに対応する堅牢なエラー処理を実装しています。
Ethereumプロバイダーへの接続中にネットワークエラーが発生する
無効なENS名またはEthereumアドレス
ENS固有のエラー
一般的な操作エラー
すべてのエラーは、デバッグ用の技術的な詳細を保持しながら、ユーザーフレンドリーなメッセージに正規化されます。
出版
npm パッケージとして公開するには:
npm publish --access publicトラブルシューティング
エラーが発生した場合:
Ethereumプロバイダーが動作し、アクセス可能であることを確認する
照会するENS名が正しくフォーマットされていることを確認してください
ENSライブラリの最新バージョンがあることを確認してください
PROVIDER_URL環境変数でカンマ区切りで複数のプロバイダを使用してみてください
ライセンス
このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。
Available Tools
8 toolscheck-availabilityA
Check if an ENS name is available for registration
Inputs: name (required).
get-all-recordsB
Get all available information for an ENS name
Inputs: name (required).
get-name-historyC
Get the history of an ENS name
Inputs: name (required).
get-registration-priceC
Get the price to register an ENS name
Inputs: name (required), duration.
get-subdomainsC
Get subdomains for an ENS name
Inputs: name (required).
get-text-recordC
Get a text record for an ENS name
Inputs: key (required), name (required).
resolve-nameB
Resolve an ENS name to an Ethereum address
Inputs: name (required).
reverse-lookupB
Get the ENS name for an Ethereum address
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no overlap: availability checks, retrieving records/history/price/subdomains/text, resolving names, and reverse lookups. The descriptions make it easy to differentiate between tools like 'get-all-records' (comprehensive info) and 'get-text-record' (specific record type).
The naming follows a consistent verb-object pattern with hyphens (e.g., 'check-availability', 'get-all-records'), except for 'reverse-lookup' which uses a different verb style. This minor deviation slightly reduces consistency, but the overall pattern remains highly readable and predictable.
With 8 tools, the count is well-scoped for an ENS server, covering key operations like checking availability, retrieving various data types, resolving addresses, and reverse lookups. Each tool earns its place without feeling excessive or insufficient for the domain.
The toolset provides strong coverage for querying and resolving ENS names, including availability, records, history, price, subdomains, text records, and bidirectional resolution. A minor gap is the lack of write operations (e.g., registering or updating names), but the read-focused surface is nearly complete for its apparent purpose.
Maintenance
Related MCP Connectors
ENS names: resolve, read profiles and ownership, list names, prepare registrations and changes
44 MCP tools to search, value, register, trade, and manage ENS names. AI-powered intelligence layer.
EVM chain reads for agents: balances, gas, fees, blocks, txs, logs, ENS. 15 tools, x402 per call.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude to interact with Ethereum nodes, allowing users to check ENS token balances, view smart contract code, and decode transactions through natural language.51MIT
- AlicenseBqualityDmaintenanceProvides Claude with access to Ethereum and EVM-compatible blockchain operations, enabling wallet management, transaction handling, contract interactions, and blockchain queries through natural language.35136 npm10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with the Ethereum Name Service via natural language, supporting lookups, availability checks, pricing, subnames, and onchain records.15Apache 2.0
- AlicenseAqualityDmaintenanceAI-powered ENS intelligence for autonomous agents, enabling search, valuation, trading, and management of ENS domains via the Model Context Protocol.44AGPL 3.0