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）：登録期間（年）
**返品:**登録価格の内訳（基本価格、プレミアム、合計）

設定

前提条件

Node.js (v16 以上)
npmまたはyarn
Ethereum RPC プロバイダーへのアクセス (パブリックまたはプライベート)

インストール

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

git clone https://github.com/JustaName-id/ens-mcp-server

依存関係をインストールします:

npm i

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ファイルをご覧ください。

ENS MCP Server

Integrations