Skip to main content
Glama

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 プロバイダーへのアクセス (パブリックまたはプライベート)

インストール

  1. リポジトリをクローンするか、新しいプロジェクトを作成します。

git clone https://github.com/JustaName-id/ens-mcp-server
  1. 依存関係をインストールします:

npm i
  1. Ethereum プロバイダーを構成する: 次の内容を含む.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 tools
check-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

    B3.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    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).

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers