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 Etherscan Server

設定

前提条件

• Node.js (v16 以上)

• npmまたはyarn

• Ethereum RPC プロバイダーへのアクセス (パブリックまたはプライベート)

インストール

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

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

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

npm i

3. Ethereum プロバイダーを構成する: 次の内容を含む.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 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ファイルをご覧ください。